skills

내가 만드는 AI agent skill 들을 관리하는 저장소입니다.

각 skill은 SKILL.md(frontmatter + 본문)와 선택적인 부속 스크립트·참고 자료를 담은 하나의 디렉토리로 구성됩니다. Claude Code / Claude Agent SDK에서 사용하는 skill 형식을 따릅니다.

디렉토리 구조

skills/
├── README.md            # 이 문서
├── .gitignore
├── _template/           # 새 skill을 만들 때 복사해서 시작하는 템플릿
│   ├── SKILL.md
│   ├── scripts/         # skill이 실행하는 스크립트
│   └── references/      # 본문이 무거워지지 않도록 분리한 참고 자료
├── skills/              # 실제 skill 들이 들어가는 곳 (skill 하나 = 디렉토리 하나)
│   └── <skill-name>/
│       ├── SKILL.md
│       ├── scripts/
│       └── references/
└── docs/                # skill 작성 가이드, 공통 규칙 등

SKILL.md 형식

각 skill의 진입점은 SKILL.md 이며 YAML frontmatter로 시작합니다.

---
name: skill-name
description: 무엇을 하고 언제 호출해야 하는지 한 줄로. 트리거 조건을 구체적으로.
---

# 본문 (사용법, 단계, 참고)

• name: kebab-case. 디렉토리 이름과 일치시키는 것을 권장합니다.
• description: 모델이 "언제 이 skill을 쓸지" 판단하는 근거가 되므로 트리거를 명확히 적습니다.

새 skill 추가하기

cp -r _template skills/<skill-name>
# skills/<skill-name>/SKILL.md 의 name / description / 본문을 수정

작성 후 frontmatter의 name과 디렉토리 이름이 일치하는지 확인하세요.

규칙

• skill 하나당 디렉토리 하나, 하나의 명확한 역할.
• 큰 참고 자료는 SKILL.md 본문에 넣지 말고 references/로 분리합니다.
• 실행 코드는 scripts/에 두고 SKILL.md에서 호출 방법을 설명합니다.