본문 바로가기
C.W.K.
Stream
Lesson 06 of 13 · published

Skill 체계와 SKILL.md

~18 min · skills, skill-md, frontmatter, auto-invocation

Level 0🌱 입문자
0 XP0/70 lessons0/11 achievements
0/120 XP to next level120 XP to go0% complete

Skill은 반복 지시를 재사용 가능한 능력으로 묶어

사용자 정의 슬래시 명령이 Markdown 한 장이라면 Skill은 그 주위에 설정과 자료, 스크립트를 함께 둘 수 있는 폴더야. SKILL.md 머리말에서 언제 불러올지, 어떤 인자를 받을지, 어떤 파일을 함께 읽을지, 어느 모델과 격리된 하위 에이전트를 쓸지 정해.

처음에는 직접 /skill-name으로 불러서 결과를 검증해. 설명이 정확한 상황에서만 안정적으로 작동한다는 확신이 생기면 자동 호출로 넓히는 게 안전해. 너무 일찍 자동화하면 엉뚱한 작업에 Skill이 끼어들어.

Skill의 가장 큰 장점은 한 제품에 갇히지 않는다는 거야. 공개 Agent Skills 표준을 따르기 때문에 같은 SKILL.md를 Claude Code와 Cowork, 호환 도구에서 다시 쓸 수 있어. 잘 만든 Skill 하나가 여러 작업 환경의 공통 자산이 되는 셈이지.

직접 확인할 항목: /batch, /claude-api, /debug, /loop, /simplify, arguments:, invocation: explicit|auto|disabled, model:, paths:, subagent: true, {{name}}.

Code

필요할 때 자동으로 불리는 SKILL.md·markdown
---
name: security-audit
description: |
  OWASP-aware security audit of a file or directory.
  Auto-invoked when the user asks about "security" or "vulnerabilities".
invocation: auto
arguments:
  - name: target
    description: File or directory to audit
    required: true
paths:
  - checklists/owasp-top10.md
model: claude-opus-4-7
subagent: true
---

You are a senior application security engineer. Audit {{target}} for:

1. SQL injection vulnerabilities
2. XSS attack vectors
3. Authentication / authorization flaws
4. Sensitive data exposure
5. Insecure direct object references

Reference checklists/owasp-top10.md. Output:
[SEVERITY] Description — File:Line — Remediation
Skill 폴더 구성·text
.claude/
└── skills/
    └── security-audit/
        ├── SKILL.md
        ├── checklists/
        │   └── owasp-top10.md
        └── remediation-templates/
            ├── sql-injection.md
            └── xss.md

External links

Exercise

기꺼이 맡길 수 있는 작업 하나를 골라 Skill을 만들어. 보안 감사, 성능 검토, 문서 생성처럼 무엇이든 좋아. 머리말에는 description, arguments, invocation을 꼭 넣어. 먼저 직접 호출해 동작을 증명하고, 안정적일 때 auto로 바꿔.

Progress

Progress is local-only — sign in to sync across devices.
이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

댓글 0

🔔 답글 알림 (로그인 필요)
로그인댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.