{"id":"claude-code-skills","kind":"workflow","testedWith":[],"durationMin":15,"url":"https://opencurrent.ai/w/claude-code-skills","title":"반복 작업을 스킬로 만들기","summary":"자주 하는 작업 순서를 스킬로 적어 두면, 매번 설명하지 않아도 /이름 한 번이나 상황에 맞춰 Claude가 같은 절차대로 처리합니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"code","label":"코드 작성"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Claude Code"],"whenToUse":".claude/skills/<이름>/SKILL.md에 설명과 절차를 적고 /이름으로 불러 봅니다. 인자는 $ARGUMENTS로 받고, 저절로 불리면 곤란한 작업은 disable-model-invocation으로 직접 부를 때만 돌게 합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.","prerequisites":["Claude Code 설치와 로그인"],"inputs":[],"howToFollow":"1. 준비물이 갖춰졌는지 먼저 확인할 것.\n2. 단계를 순서대로 진행할 것. kind가 \"ai\"면 프롬프트를 실행하고, \"command\"면 사용자의 허락을 받고 명령을 실행하고, \"human\"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.\n3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.\n4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.\n5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"command","title":"스킬 폴더 만들기","body":"프로젝트에서 팀과 나눌 스킬은 .claude/skills/<이름>/에, 나만 쓸 스킬은 ~/.claude/skills/<이름>/에 둡니다. 폴더 이름이 곧 명령 이름입니다.","prompt":"mkdir -p .claude/skills/release-notes","expected":"빈 스킬 폴더","check":"폴더가 생겼는지 확인","tool":"Claude Code"},{"n":2,"kind":"human","title":"SKILL.md 쓰기","body":"맨 위 YAML에 description을 적습니다. Claude는 이 설명을 보고 언제 스킬을 쓸지 정하므로 \"무엇을, 언제\"를 분명히 씁니다. 본문에는 절차를 순서대로 적습니다.","prompt":"---\ndescription: 지난 태그 이후 커밋으로 릴리스 노트를 만든다. 릴리스 노트, 변경 기록 요청에 쓴다.\nargument-hint: [버전]\n---\n1. git log로 마지막 태그 이후 커밋을 모은다.\n2. 기능·수정·기타로 나눠 $ARGUMENTS 버전의 릴리스 노트를 쓴다.\n3. CHANGELOG.md 맨 위에 붙인다.","expected":".claude/skills/release-notes/SKILL.md","check":"파일이 ---로 시작하는지 확인","tool":"Claude Code"},{"n":3,"kind":"command","title":"불러 보기","body":"/이름 뒤에 인자를 붙여 부릅니다. 새 스킬이 목록에 없으면 /reload-skills를 실행합니다.","prompt":"/release-notes 1.4.0","expected":"스킬 절차대로 만든 릴리스 노트","check":"CHANGELOG.md 맨 위에 1.4.0 항목이 생겼는지 확인","tool":"Claude Code"},{"n":4,"kind":"human","title":"저절로 불리지 않게 하기","body":"배포처럼 부르는 때를 사람이 정해야 하는 스킬은 frontmatter에 disable-model-invocation: true를 넣습니다. 목록에서 숨기려면 user-invocable: false를 씁니다.","prompt":"disable-model-invocation: true","expected":"직접 부를 때만 도는 스킬","check":"관련 요청을 해도 스킬이 저절로 불리지 않는지 확인","tool":"Claude Code"},{"n":5,"kind":"command","title":"예전 명령 옮기기","body":".claude/commands/의 명령 파일은 그대로 동작하지만, 보조 파일을 함께 두려면 스킬 폴더로 옮깁니다. .claude/commands/deploy.md를 .claude/skills/deploy/SKILL.md로 옮기면 /deploy가 그대로 유지됩니다.","prompt":"mkdir -p .claude/skills/deploy && git mv .claude/commands/deploy.md .claude/skills/deploy/SKILL.md","expected":"스킬로 옮긴 명령","check":"/deploy가 계속 동작하는지 확인","tool":"Claude Code"}],"pitfalls":["description이 모호하면 엉뚱한 때 불리거나 안 불림. 쓰는 상황을 구체적으로","스킬이 실행하는 명령도 권한 규칙을 따름. allowed-tools로 필요한 도구만 열기","출처를 모르는 스킬은 안의 파일과 명령을 읽고 넣기"],"sources":[{"title":"Claude Code 문서: 스킬","url":"https://code.claude.com/docs/en/skills"},{"title":"Claude Code 문서: 내장 명령","url":"https://code.claude.com/docs/en/commands"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-21T10:00:00+00:00","basis":"updated"},"updatedAt":"2026-11-21T10:00:00+00:00","goals":[{"id":"dev","title":"개발"}],"uses":0,"likes":0}