Skip to main content

Skills

Skills는 재사용 가능한 프롬프트 모듈입니다. SKILL.md를 로드하여 특정 도메인용 지시를 세션에 추가할 수 있습니다.

개요

  • 도메인 지식을 스킬로 재사용할 수 있음
  • 프로젝트 간에 동일한 동작을 공유할 수 있음
  • 세션 단위로 활성/비활성 전환 가능
Laravel 버전에서는 SessionConfig의 skillDirectories와 disabledSkills를 사용해 설정합니다.

기본 사용법

skillDirectories는 스킬을 검색하기 위한 명시적인 루트입니다. enableConfigDiscovery 설정과는 독립적으로 사용할 수 있습니다. 부모 디렉터리를 지정하면 그 아래의 각 서브디렉터리에 있는 SKILL.md가 검색됩니다. 이는 검색 전용이며, 에이전트에 일반적인 파일 접근 권한을 부여하지 않습니다.
배열 형식으로도 지정할 수 있습니다.

스킬 비활성화

disabledSkills를 사용하면 로드된 스킬의 일부만 비활성화할 수 있습니다.

디렉터리 구성

skillDirectories에는 skills/와 같은 부모 디렉터리를 지정합니다. 상대 경로는 지정 시점의 유효한 workingDirectory를 기준으로 한 번만 해석됩니다.
  • 생략 또는 null: 다른 검색 소스를 변경하지 않습니다
  • []: 명시한 SDK 루트만 비웁니다
disabledSkills, 소스 단위 비활성화, Managed Settings는 명시적 루트에서 검색한 스킬에도 적용됩니다.

SKILL.md 형식

SKILL.md는 Markdown이며, YAML frontmatter를 임의로 붙일 수 있습니다.
frontmatter의 주요 항목:
  • name: 스킬 식별자(disabledSkills에서 지정하는 이름)
  • description: 스킬의 짧은 설명
name을 생략한 경우 디렉터리 이름이 사용됩니다.

Custom Agents와 조합

customAgents[].skills에 스킬 이름을 지정하면 대상 에이전트 기동 시에 해당 스킬 내용이 사전에 로드됩니다.
skills를 생략한 경우, 에이전트에 스킬 내용은 주입되지 않습니다.

RPC로 확인, 조작

스킬 검출이나 활성/비활성 전환은 RPC에서도 조작할 수 있습니다.

베스트 프랙티스

  • 스킬은 도메인별로 분할(skills/security, skills/testing 등)
  • frontmatter에 name과 description을 붙임
  • 충돌하는 지시가 있는 경우 disabledSkills로 명시적으로 제외
  • 우선 단독으로 동작 확인한 후 여러 스킬을 조합

참고

마지막 수정일 2026년 10월 19일