문서

Claude Agent Skills란 무엇인가?

Claude Agent Skill은 도메인 전문 지식, 규칙, 워크플로우, 모범 사례를 일반 텍스트로 담은 SKILL.md 파일입니다.

Skills 작동 방식

  1. 1 SKILL.md 파일을 프로젝트(또는 ~/.claude/skills/ 디렉터리)에 배치합니다.
  2. 2 Claude는 매 세션 시작 시 파일을 읽어 반복 프롬프트 없이 지식을 흡수합니다.
  3. 3 Skills는 지연 로딩을 사용합니다: Claude는 먼저 이름과 설명만 보고, 관련 있을 때만 전체 파일을 읽어 토큰을 절약합니다.

예시

  • 앱의 아키텍처, 명명 규칙, 일반적인 패턴을 아는 Laravel skill.
  • OWASP 체크리스트와 코드 리뷰 절차가 포함된 보안 감사 skill.
  • Claude가 항상 회사의 톤으로 글을 쓸 수 있도록 하는 브랜드 가이드라인 skill.

지연 로딩

Skills는 토큰 효율적입니다. Claude는 먼저 Skill 이름과 한 줄 설명만 봅니다. 현재 작업과 관련 있을 때만 전체 SKILL.md를 읽으므로, 많은 Skill을 설치해도 컨텍스트가 과부하되지 않습니다.

Skills vs MCP 도구

Skills와 MCP(Model Context Protocol) 도구는 상호 보완적입니다 — 서로 다른 문제를 해결합니다.

Skills

  • 지식, 전문성, 워크플로우 제공
  • 일반 텍스트 — 코드 실행 없음
  • 웹, 데스크톱, CLI에서 작동
  • 최적 용도: 규칙, 도메인 지식, 글쓰기 스타일

MCP 도구

  • API, 데이터베이스, 외부 도구에 연결
  • 코드 실행 및 네트워크 호출
  • 데스크톱 또는 CLI 필요 (웹 불가)
  • 최적 용도: 실시간 데이터, 파일 작업, 통합