SKILL.md 머리말 — 모든 설정 항목

~16 min · skills, frontmatter, yaml, config

Level 0🌱 입문자

0 XP0/70 lessons0/11 achievements

0/120 XP to next level120 XP to go0% complete

SKILL.md의 머리말은 이 능력을 연결하는 계약이야

본문이 실제 작업 지시라면 YAML 머리말은 도구가 그 지시를 언제 어떻게 쓸지 정해. name은 호출 이름, description은 무엇을 언제 쓰는지, invocation은 직접·자동·비활성 여부를 나타내. arguments는 입력값, paths는 함께 읽을 자료, model과 subagent는 실행 환경을 고르고.

자동 호출에서는 설명이 곧 라우터야. "보안 거"처럼 흐린 문장보다 "OWASP 기준으로 웹 API 변경을 감사할 때"처럼 대상과 시점을 함께 적어야 엉뚱한 작업에 끼어들지 않아. subagent: true는 긴 작업을 격리하지만 주 세션에서 중간 과정이 덜 보이는 대가도 기억해.

머리말의 핵심은 name·description·invocation·arguments·paths·model·subagent와 버전 관리까지 모두 8가지야.

직접 확인할 항목: /name, auto, disabled, explicit, version, {{name}}.

Code

관련 필드를 모두 넣은 머리말·markdown

---
name: security-audit
description: |
  OWASP-aware security audit of a file or directory.
  Auto-invoke when user mentions "security", "vulnerability",
  or asks about auth/payments/data-handling code.
invocation: auto
arguments:
  - name: target
    description: File or directory to audit
    required: true
  - name: severity_floor
    description: Lowest severity to include (low | medium | high)
    required: false
    default: low
paths:
  - checklists/owasp-top10.md
  - templates/finding.md
model: claude-opus-4-7
subagent: true
---

인수 치환과 본문에서 참조하기·markdown

You are a senior application security engineer.

Audit {{target}}. Use checklists/owasp-top10.md as the floor.
For each finding:
- Severity (CVSS 3.1)
- File:line citation
- CWE class
- Remediation snippet

Filter to severity >= {{severity_floor}}.
Format each finding using templates/finding.md.

External links

SKILL.md 머리말 참고 자료

Exercise

기존 Skill 하나를 골라 아직 쓰지 않던 머리말 필드 3개를 추가해 봐. arguments 항목 1개, paths 항목 1개, 의미가 분명한 description을 넣어. 예상한 상황에서 자동 호출이 제대로 작동하는지도 확인해.

Progress

Progress is local-only — sign in to sync across devices.

← PreviousSkill이란 무엇인가 Next →Markdown 본문 — 명확한 지시와 분명한 경계

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

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