---
name: opencurrent-code-skills
description: "자주 하는 작업 순서를 스킬로 적어 두면, 매번 설명하지 않아도 /이름 한 번이나 상황에 맞춰 Claude가 같은 절차대로 처리합니다. 이럴 때 사용: .claude/skills/이름/SKILL.md에 설명과 절차를 적고 /이름으로 불러 봅니다. 인자는 $ARGUMENTS로 받고, 저절로 불리면 곤란한 작업은 disable-model-invocation으로 직접 부를 때만 돌게 합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다. 도구: Claude Code."
metadata:
  source: "https://opencurrent.ai/w/claude-code-skills"
  opencurrent-id: "claude-code-skills"
  verification: "pending"
  exported-at: "2026-11-21T11:14:33.180Z"
---

# 반복 작업을 스킬로 만들기

자주 하는 작업 순서를 스킬로 적어 두면, 매번 설명하지 않아도 /이름 한 번이나 상황에 맞춰 Claude가 같은 절차대로 처리합니다.

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/claude-code-skills
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("claude-code-skills")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

.claude/skills/<이름>/SKILL.md에 설명과 절차를 적고 /이름으로 불러 봅니다. 인자는 $ARGUMENTS로 받고, 저절로 불리면 곤란한 작업은 disable-model-invocation으로 직접 부를 때만 돌게 합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

## 준비물

- Claude Code 설치와 로그인

## 단계

### 1. 스킬 폴더 만들기 (명령 실행 · Claude Code)

프로젝트에서 팀과 나눌 스킬은 .claude/skills/<이름>/에, 나만 쓸 스킬은 ~/.claude/skills/<이름>/에 둡니다. 폴더 이름이 곧 명령 이름입니다.

프롬프트:

```text
mkdir -p .claude/skills/release-notes
```

기대 결과: 빈 스킬 폴더

확인 방법: 폴더가 생겼는지 확인

### 2. SKILL.md 쓰기 (사람이 · Claude Code)

맨 위 YAML에 description을 적습니다. Claude는 이 설명을 보고 언제 스킬을 쓸지 정하므로 "무엇을, 언제"를 분명히 씁니다. 본문에는 절차를 순서대로 적습니다.

프롬프트:

```text
---
description: 지난 태그 이후 커밋으로 릴리스 노트를 만든다. 릴리스 노트, 변경 기록 요청에 쓴다.
argument-hint: [버전]
---
1. git log로 마지막 태그 이후 커밋을 모은다.
2. 기능·수정·기타로 나눠 $ARGUMENTS 버전의 릴리스 노트를 쓴다.
3. CHANGELOG.md 맨 위에 붙인다.
```

기대 결과: .claude/skills/release-notes/SKILL.md

확인 방법: 파일이 ---로 시작하는지 확인

### 3. 불러 보기 (명령 실행 · Claude Code)

/이름 뒤에 인자를 붙여 부릅니다. 새 스킬이 목록에 없으면 /reload-skills를 실행합니다.

프롬프트:

```text
/release-notes 1.4.0
```

기대 결과: 스킬 절차대로 만든 릴리스 노트

확인 방법: CHANGELOG.md 맨 위에 1.4.0 항목이 생겼는지 확인

### 4. 저절로 불리지 않게 하기 (사람이 · Claude Code)

배포처럼 부르는 때를 사람이 정해야 하는 스킬은 frontmatter에 disable-model-invocation: true를 넣습니다. 목록에서 숨기려면 user-invocable: false를 씁니다.

프롬프트:

```text
disable-model-invocation: true
```

기대 결과: 직접 부를 때만 도는 스킬

확인 방법: 관련 요청을 해도 스킬이 저절로 불리지 않는지 확인

### 5. 예전 명령 옮기기 (명령 실행 · Claude Code)

.claude/commands/의 명령 파일은 그대로 동작하지만, 보조 파일을 함께 두려면 스킬 폴더로 옮깁니다. .claude/commands/deploy.md를 .claude/skills/deploy/SKILL.md로 옮기면 /deploy가 그대로 유지됩니다.

프롬프트:

```text
mkdir -p .claude/skills/deploy && git mv .claude/commands/deploy.md .claude/skills/deploy/SKILL.md
```

기대 결과: 스킬로 옮긴 명령

확인 방법: /deploy가 계속 동작하는지 확인

## 주의할 점

- description이 모호하면 엉뚱한 때 불리거나 안 불림. 쓰는 상황을 구체적으로
- 스킬이 실행하는 명령도 권한 규칙을 따름. allowed-tools로 필요한 도구만 열기
- 출처를 모르는 스킬은 안의 파일과 명령을 읽고 넣기

## 출처

- [Claude Code 문서: 스킬](https://code.claude.com/docs/en/skills)
- [Claude Code 문서: 내장 명령](https://code.claude.com/docs/en/commands)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/claude-code-skills 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
