Claude Code의 Skills와 Commands를 만드는 방법을 몰라서 정리해 본 건

안녕하세요, 타쿠타입니다.

✅ 매번 똑같은 것을 부탁하는 게 귀찮다……

✅ 이전에 했던 작업을 다시 하고 싶은데 방법을 잊어버렸다

✅ 단순 작업을 자동화할 수 없을까……

이런 분들, 계시지 않나요?

사실 Claude Code에는, 자주 사용하는 작업을 「Skills」나 「Commands」로 등록해 두는 기능이 있습니다.

한 번 등록해 두면, 그다음부터는 말을 걸거나 명령어를 입력하는 것만으로 자동으로 수행해 줍니다.

본 기사를 참고하여 자신만의 「Skills」나 「Commands」를 만들어 봅시다.

먼저 대략적인 이미지를 파악해 봅시다.

기능	저장 위치	호출 방법
Skills (스킬)	~/.claude/skills/	말을 거는 것만으로 자동 실행
Commands (명령어)	~/.claude/commands/	/명령어명 이라고 입력하여 실행

Skills: 자연어로 말을 걸면, Claude가 문맥을 판단하여 자동으로 실행합니다 -
Commands: /publish와 같이 /명령어명을 명시적으로 입력하여 실행합니다

둘 다 「Claude를 위한 지시서를 사전에 등록해 두는」 구조로, 한 번 만들어 두면 몇 번이고 재사용할 수 있습니다.

Skills와 Commands는 각각 별도의 폴더에서 관리합니다.

Windows의 경우

C:\Users\사용자이름\.claude\skills\

Mac의 경우

/Users/사용자이름/.claude/skills/

Windows의 경우

C:\Users\사용자이름\.claude\commands\

Mac의 경우

/Users/사용자이름/.claude/commands/

📝

필자의 환경에서의 보충 설명

필자의 환경에서는 ~/.claude/commands/에 파일을 두는 것만으로 「Skills」, 「Commands」 양쪽 모두로 동작했습니다.

단, 이는 환경에 따라 다를 수 있으므로 잘 작동하지 않는 경우에는 각각의 폴더에 저장해 보세요.

파일을 만드는 방법은 크게 두 가지가 있습니다.

방법 ①: Claude Code로 작업하기 → 「skill-creator」 플러그인에 맡겨서 자동 생성하기 -
방법 ②: 직접 파일을 생성하기

✅ 「직접 쓰는 것이 서툰」 분은 ①

✅ 「세세하게 직접 컨트롤하고 싶은」 분은 ②

가 적합합니다.

⚠️

주의

「skill-creator」는 Claude Code의 표준 기능이 아니라, 별도로 설치가 필요한 플러그인입니다.

「Skills」나 「Commands」를 작성할 경우에는 별도로 설치해 주시기 바랍니다.

Claude Code와 함께 작업하면서, 「이 작업, 매번 하게 될 것 같네」라고 느껴지는 타이밍.

스텝 1: Claude Code로 평소처럼 작업하기

예를 들어 「기사를 GitHub에 push하고, Zenn과 Qiita에 게시한다」라는 일련의 작업을 Claude Code와 함께 한다고 가정해 봅시다.

스텝 2: 작업이 끝나면 skill-creator에게 의뢰하기

이렇게 말하는 것만으로 OK입니다:

아까 했던 「기사를 push해서 Zenn과 Qiita에 게시하는」 작업을
skills로 등록해 줄래?
commands에도 같은 내용을 등록해 줘

그러면 skill-creator가 자동으로 파일을 만들어 줍니다.

스텝 3: 동작 확인

「기사를 push해줘」라고 말을 걸어보고, 제대로 작동하는지 확인합니다.

• 「어떤 말로 호출하고 싶은지」도 함께 전달하면 인식 정밀도가 높아집니다.
• 예: 「『기사를 공개해줘』 『Zenn에 게시해줘』라고 말하면 우선적으로 실행되도록 해줘」

직접 파일을 만드는 방법입니다. skill-creator가 없어도 사용할 수 있습니다.

저장 위치 (Windows)

C:\Users\사용자이름\.claude\commands\

저장 위치 (Mac)

/Users/사용자이름/.claude/commands/

절차

• 위 폴더에 원하는이름.md 파일을 생성한다.
• 필요에 따라 Claude Code를 재시작하면 /파일명으로 호출할 수 있다.

작성 예시: publish-articles.md

articles/ 폴더의 변경 사항을 GitHub에 push해 주세요.
리포지토리(Repository) 위치: C:\Users\사용자이름\Documents\my-articles
절차:
...

"Claude에게 부탁하는 메모"를 만든다는 느낌으로 작성하면 OK입니다.

저장 위치 (Windows)

C:\Users\사용자이름\.claude\skills\

저장 위치 (Mac)

/Users/사용자이름/.claude/skills/

절차

• 위 폴더에 원하는이름.md 파일을 생성한다.
• 파일 안에 "Claude를 향한 지시"와 "어떤 말로 호출할 것인가"를 작성한다.

작성 예시: save-article.md

다음과 같은 의뢰가 왔을 경우에는 이 스킬(Skill)을 우선적으로 이용할 것.
- 마크다운 (Markdown) 형식으로 정리해 줘
- 기사로 만들어 줘
...

ℹ️

포인트

Skills는 "반드시 실행되는" 것이 아니라, Claude가 문맥(Context)을 판단하여 "우선적으로 실행하는" 것입니다.

등록한 자연어(Natural Language)로 높은 확률로 동작하지만, 완전히 보장되는 것은 아닙니다.

저는 Claude Code를 사용하여, Zenn과 Qiita라는 엔지니어 노하우 공유 사이트에 기사를 자동 게시하는 메커니즘을 만들었습니다.

① Claude Code로 기술에 대해 배우고 심층 탐구한다
↓
② "마크다운 형식으로 정리해 줘"라고 말한다
...

이 3단계로 기사 작성부터 게시까지 완료됩니다.

기능	저장 위치	호출 방법	용도
Skills	~/.claude/skills/	자연어로 말하기	자주 사용하는 작업을 자동화
Commands	~/.claude/commands/	/명령어이름으로 명시적으로 실행	정해진 절차를 확실하게 재현

Skills는 자연어로 재사용할 수 있는 작업 템플릿. Claude가 문맥을 판단하여 실행합니다 -
Commands는 /명령어이름으로 호출할 수 있는 정형 처리. 확실하게 실행하고 싶은 절차에 적합합니다 -
만드는 방법은 ① skill-creator 플러그인(설치 필요)과 ② 수동 파일 생성의 2가지 종류

• 파일 내용은 "Claude에게 부탁하는 메모"를 적기만 하면 OK
• 한 번 만들면 몇 번이고 다시 사용할 수 있으므로, 자주 사용하는 작업은 적극적으로 등록해 보세요

Claude Code는 "잘 다룰수록 자신만의 전용 어시스턴트가 되어가는" 도구입니다. 처음에는 어렵게 느껴질 수도 있지만, 한 번 만들어 두면 그다음부터는 편해지므로 꼭 시도해 보세요!