용어집
《Claude Code Skills: 나만의 AI 워크플로 만들기》의 용어 49개. 레슨 본문에서 처음 등장하는 용어에 마우스를 올리면 정의를 볼 수 있습니다.
| 용어 | 정의 | 출처 |
|---|---|---|
| 스킬 | 디렉터리와 SKILL.md 파일로 이루어진, 재사용 가능한 워크플로 지시문 패키지. Claude에게 특정 작업을 수행하는 방법을 알려준다. | Anthropic 엔지니어링 블로그: Equipping agents for the real world with Agent Skills |
| SKILL.md | 스킬의 핵심 파일로, YAML 프론트매터(메타데이터)와 Markdown 지시문(Claude가 따를 지시)이라는 두 부분으로 구성된다. | Claude Code 공식 문서: Extend Claude Code with skills |
| YAML 프론트매터 | SKILL.md 맨 위에 있는 삼중 대시(---) 마커로 감싸인 메타데이터 블록. name과 description 같은 필드를 담는다. | Claude Code 공식 문서: Extend Claude Code with skills |
| name | 스킬의 고유 식별자를 정의하는 필수 프론트매터 필드. 명령이 되므로 소문자, 숫자, 하이픈만 사용해야 한다. | Anthropic 엔지니어링 블로그: Equipping agents for the real world with Agent Skills |
| description | 스킬이 무엇을 하고 언제 사용하는지 Claude에게 알려주는 필수 프론트매터 필드. 자동 트리거의 유일한 근거다. | Building skills for Claude 실습: YAML frontmatter와 테스트 |
| 자동 트리거 | 사용자가 말한 내용이 스킬의 description과 일치하면, Claude가 수동 명령 없이 스스로 그 스킬을 로드하고 실행하는 것. | Building skills for Claude 실습: YAML frontmatter와 테스트 |
| 수동 호출 | /skill-name으로 스킬을 직접 호출하는 것. description 매칭에 의존하지 않고 Claude가 강제로 로드하게 한다. | Claude Code 공식 문서: Extend Claude Code with skills |
| Markdown 지시문 | 프론트매터 뒤에 오는 SKILL.md의 모든 내용. Claude가 따르는 구체적이고 단계별 지시문이며, Markdown으로 작성된다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 점진적 공개 | 한꺼번에 모든 세부사항을 쏟아붓는 대신, Claude에게 지금 당장 필요한 것만 제공해 스킬을 짧게 유지하고 빠르게 로드되게 하는 것. | Anthropic 플랫폼 문서: Agent Skills overview |
| 보조 파일 | SKILL.md 외에 스킬 디렉터리에 있는 파일들(체크리스트, 설정, 스크립트)로, 요청 시에만 로드되어 초기 컨텍스트를 소비하지 않는다. | Anthropic 플랫폼 문서: Agent Skills overview |
| 개인 스킬 | ~/.claude/skills/에 저장되어 자신만 사용할 수 있지만 모든 프로젝트에서 쓸 수 있는 스킬. 개인 습관과 범용 도구에 좋다. | Teach Claude Code your workflow: 커스텀 Skills 실습 가이드 |
| 프로젝트 스킬 | 프로젝트의 .claude/skills/ 디렉터리에 저장되고 Git에 커밋되어, 팀원들이 저장소를 클론할 때 자동으로 받게 되는 스킬. | Teach Claude Code your workflow: 커스텀 Skills 실습 가이드 |
| 반복성 | 시나리오가 스킬에 적합한 세 가지 특성 중 하나: 매일, 매주, 때로는 매시간 같은 일을 반복한다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 고정된 단계 | 시나리오가 스킬에 적합한 세 가지 특성 중 하나: 매번 바뀌지 않고 명확한 단계로 프로세스를 작성할 수 있다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 검증 가능성 | 시나리오가 스킬에 적합한 세 가지 특성 중 하나: Claude가 결과를 제대로 냈는지 판단할 수 있다. | Claude Code 공식 문서: Extend Claude Code with skills |
| description 공식 | 효과적인 description을 작성하기 위한 가이드라인: 무엇을 하는지 + 언제 사용하는지 + 주요 기능. | Building skills for Claude 실습: YAML frontmatter와 테스트 |
| 트리거 키워드 | description에 있는 단어 중 사용자가 실제로 말할 법한 것. Claude는 이것들을 매칭해서 스킬을 자동 로드할지 결정한다. | Building skills for Claude 실습: YAML frontmatter와 테스트 |
| 입력 형식 | 스킬이 받는 입력의 종류를 명시하는 지시문 섹션. 형태, 출처, 구체적인 예시를 포함한다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 처리 단계 | 스킬이 실행하는 순서가 있고 구체적인 작업들. 지시문의 핵심이며, 각 단계는 모호하지 않을 만큼 충분히 구체적이어야 한다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 출력 형식 | 결과가 어떤 모습이어야 하는지 정의하는 지시문 섹션. 구조, 기호, 완성된 예시를 포함한다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 엣지 케이스 | 비정상적이거나 이례적인 입력(빈 입력, 형식이 잘못된 입력, 너무 긴 콘텐츠)으로, 처리 방법을 지시문에 명시적으로 작성해야 한다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 직접 호출 | 가장 단순한 테스트: /skill-name으로 스킬을 호출하고 출력이 기대와 일치하는지 관찰한다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 테스트 케이스 | 신뢰하기 전에 스킬을 체계적으로 테스트하는 데 사용되는, 준비된 입력-예상 출력 쌍. | Claude Code 공식 문서: Extend Claude Code with skills |
| 반복 루프 | 스킬이 거치는 테스트-발견-수정-재테스트 사이클. '실행된다'에서 '잘 실행된다'로 가는 경로. | Claude Code skills: .NET 워크플로와 재사용 가능한 프롬프트 |
| A/B로 비교하기 | 스킬 있이와 스킬 없이 같은 작업을 실행하고 둘 다 시간을 재서, 스킬이 실제로 더 빠르고 일관적인지 증명하는 것. | Claude Code skills: .NET 워크플로와 재사용 가능한 프롬프트 |
| 체크리스트 패턴 | 복잡한 작업을 일련의 명시적 점검 항목으로 구성하는 것. 각 항목은 독립적으로 통과하거나 실패할 수 있다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 여러 단계로 이루어진 워크플로 | 복잡한 작업을 완료하기 위해 여러 순차적 단계를 실행하는 스킬. 한 단계의 출력이 다음 단계에 전달될 수 있다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 출력에 등급을 매기는 | 스킬의 발견 사항을 심각도별로 나누는 것(통과, 살펴볼 것, 반드시 고칠 것). 독자가 무엇을 먼저 조치해야 할지 알 수 있게 한다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 버전 관리 | 코드를 관리하는 것처럼, Git으로 프로젝트 스킬을 관리해 이력을 보고, 롤백하고, 버전을 비교할 수 있게 하는 것. | Claude Code skills: .NET 워크플로와 재사용 가능한 프롬프트 |
| 스킬을 리뷰하는 | 코드를 리뷰하는 것처럼 새롭거나 변경된 스킬을 리뷰하는 것. 병합 전에 description, 지시문, 테스트를 확인한다. | 자기 문서화 runbook으로서의 Claude skills |
| 네이밍 컨벤션 | 스킬 이름을 위한 팀 전체 합의 스타일: 하이픈, 동사-명사 또는 명사-동사 순서, 두세 단어. | Claude Code skills: .NET 워크플로와 재사용 가능한 프롬프트 |
| 주기적으로 솎아내기 | 분기에 한 번씩 모든 스킬을 리뷰하고, 거의 쓰이지 않는 것을 삭제하거나 개선해서, 사용되지 않는 더미가 Claude의 선택을 방해하지 않게 하는 것. | Claude Code skills: .NET 워크플로와 재사용 가능한 프롬프트 |
| 변경 알리기 | 기존 스킬을 변경한 후, 팀 채널에 변경 사항과 영향을 게시해서 사람들이 새 스킬을 옛 가정으로 운영하지 않게 하는 것. | Claude Code 공식 문서: Extend Claude Code with skills |
| 스킬 조합하기 | 하나의 더 큰 작업을 처리하기 위해 여러 단일 목적 스킬을 체인으로 연결하거나, 한 스킬 안에서 다른 스킬을 참조하는 것. | Anthropic 엔지니어링 블로그: Equipping agents for the real world with Agent Skills |
| allowed-tools | 스킬을 지정된 도구 세트로 제한하는 선택적 프론트매터 필드. 보안에 민감한 경우 권한 경계를 그린다. | Claude Skills 심층 분석(제1원리 관점) |
| disable-model-invocation | 설정하면 Claude가 스킬을 자동 로드하지 못하게 하고 수동 호출만 가능하게 하는 선택적 프론트매터 필드. 우발적 트리거를 피한다. | Claude Skills 심층 분석(제1원리 관점) |
| model | 스킬을 위한 특정 모델을 고정하는 선택적 프론트매터 필드. 예를 들어 작업이 필요로 할 때 더 강한 추론 모델을 사용한다. | Claude Skills 심층 분석(제1원리 관점) |
| MCP 서버 | Claude에게 도구(데이터베이스 액세스, API 호출)를 제공하는 Model Context Protocol 서버. 스킬은 그 도구를 사용하는 워크플로 지식을 제공한다. | The complete guide to building skills for Claude(PDF) |
| 커뮤니티 스킬 | 다른 개발자들이 만들어 공유한 스킬. GitHub 등에서 찾을 수 있다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 문서화하기 | 프로젝트 README나 .claude/README.md에 사용법과 예시를 포함해 모든 프로젝트 스킬을 나열하는 것. | 자기 문서화 runbook으로서의 Claude skills |
| 단일 책임 | 각 스킬은 하나의 일을 잘 해야 하며, 한 스킬에서 여러 관련 없는 문제를 해결하려 하지 않아야 한다. | Anthropic 엔지니어링 블로그: Equipping agents for the real world with Agent Skills |
| 컨텍스트 | Claude가 스킬을 로드할 때, SKILL.md 내용이 컨텍스트 윈도우를 차지한다. 파일이 길수록 더 많이 소비한다. | Anthropic 플랫폼 문서: Agent Skills overview |
| 필요할 때 로드한다 | 보조 파일 콘텐츠는 Claude가 실제로 필요로 할 때만 읽혀서, 스킬의 초기 로드 시에 컨텍스트를 차지하지 않는다. | Anthropic 플랫폼 문서: Agent Skills overview |
| 오탐 | 스킬이 정상 코드나 콘텐츠를 문제로 표시하는 것. '확인 필요' 카테고리를 추가하거나 기준을 조정해서 수정한다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 놓친 것 | 스킬이 찾았어야 할 문제를 잡아내지 못하는 것. 점검 규칙을 추가하거나 판단 로직을 조정해서 수정한다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 로딩 실패 | 스킬이 자동 로드되지 않거나 수동 호출이 실패할 때, 순서대로 파일 경로, 프론트매터 형식, 이름 철자를 확인하는 진단 프로세스. | Claude Code 공식 문서: Extend Claude Code with skills |
| 예시 | Claude가 예상되는 동작을 이해하도록 입력/출력 예시를 제공하는 것. 완성된 예시는 산문 설명보다 더 많은 일을 한다. | Claude Code 공식 문서: Extend Claude Code with skills |
| 피처 브랜치 | 실험적인 스킬을 Git 브랜치에서 만들거나 변경하고, 효과가 입증된 후에만 main에 병합해서 팀이 방해받지 않게 하는 것. | Claude Code 공식 문서: Extend Claude Code with skills |
| 워크플로 지식 | 단계를 구성하는 방법, 어떤 도구를 언제 사용하는지, 결과를 판단하는 방법에 관한 지식. 스킬이 제공하는 핵심 가치. | The complete guide to building skills for Claude(PDF) |