스킬로 딥 에이전트 역량 확장하기

스킬로 딥 에이전트 역량 확장하기 (Skills)

스킬(skills)로 딥 에이전트의 역량을 확장하는 방법을 다루는 페이지예요. 스킬은 워크플로우, 모범 사례, 스크립트, 참조 문서, 템플릿 같은 도메인 지식을 재사용 가능한 디렉터리로 묶어줘요. 에이전트는 시작할 때 내용의 요약만 받고, 관련 있을 때만 포함된 파일을 찾아 읽어요. 그래서 컨텍스트 블롯(context bloat)을 피할 수 있고, 여러 에이전트와 프로젝트에 걸쳐 스킬을 공유·조합할 수 있답니다.

출처: 공식문서

사용법

프로젝트에 스킬들을 담을 최상위 skills/ 디렉터리를 만들고, 그 안에 스킬별 서브디렉터리를 만들어요. 각 스킬은 SKILL.md 파일을 가진 디렉터리로, YAML 프론트매터(name과 description) 다음에 에이전트가 스킬이 활성화되었을 때 따를 지침이 들어가요. 스킬 디렉터리에는 스크립트, 참조 문서, 템플릿 같은 지원 파일도 함께 넣을 수 있어요.

예를 들어 이런 구조가 돼요:

skills/
└─ langgraph-docs/
   ├─ SKILL.md
   ├─ scripts/
   │  └─ fetch_docs.py
   ├─ references/
   │  ├─ api-patterns.md
   │  └─ style-guide.md
   └─ assets/
      ├─ report-template.md
      └─ schema.json

딥 에이전트 스킬은 Agent Skills 스펙(specification)을 따르고 있어요.

SKILL.md 작성

SKILL.md는 YAML 프론트매터로 시작하고 그다음 markdown 지침이 와요:

---
name: langgraph-docs
description: Use this skill for requests related to LangGraph in order to fetch relevant documentation to provide accurate, up-to-date guidance.
---

# langgraph-docs

## Overview

This skill explains how to access LangGraph documentation to help answer questions and guide implementation.

## Instructions

### 1. Fetch the documentation index

Use the fetch_url tool to read the following URL:
https://docs.langchain.com/llms.txt

This provides a structured list of all available documentation with descriptions.

### 2. Select relevant documentation

Based on the question, identify 2-4 most relevant documentation URLs from the index. Prioritize:

- Specific how-to guides for implementation questions
- Core concept pages for understanding questions
- Tutorials for end-to-end examples
- Reference docs for API details

### 3. Fetch and synthesize

Use the fetch_url tool to fetch the selected documentation, then synthesize an accurate, up-to-date answer based on both your knowledge and the fetched content.

더 알아보기 (Learn more)

LangChain 에코시스템 작업에서 에이전트 성능을 높여주는, 바로 쓸 수 있는 스킬들은 LangChain Skills 저장소에서 확인할 수 있어요.
스킬의 동작 방식과 세부 스펙은 Agent Skills 스펙 문서를 참고하세요.