Claude Code(Claude)에는 미리 절차를 가르쳐 둘 수 있는 「스킬 (Skill)」이라는 메커니즘이 있다. 자주 사용하는 정형 작업을 매번 처음부터 다시 설명하지 않아도, /스킬명이나 자연스러운 의뢰 문장만으로 정해진 절차와 주의 사항에 따라 동작하게 할 수 있다.

이번에는 「기술 기사를 Qiita에 게시한다」라는 작업을 다음과 같은 조건으로 스킬화하고 싶었다.

• Qiita는 API로 직접 게시할 수 있으므로, 브라우저 조작이 아닌 API를 경유한다.
• Qiita는 공개된 장소이므로, 게시 전에 반드시 내용(제목·태그·공개 범위·본문 요약)을 확인한 뒤에 게시한다.
• 사내 고유 정보(서버 이름·IP·내부 도메인 등)가 섞여 들어가지 않았는지 게시 전에 체크한다.
• 기본 공개 범위는 한정 공유(URL을 아는 사람만)로 설정해 두고, 전체 공개를 하고 싶을 때만 명시적으로 지정한다.

이 기사에서는 Claude의 「skill-creator」라는 자기 확장 기능을 사용하여, 이 「qiita 스킬」을 실제로 만들어서 자신의 계정에 등록하기까지의 절차를 정리한다.

Claude에는 미리 「skill-creator」라는, 새로운 스킬을 만들기 위한 스킬이 준비되어 있다. 이를 사용하면 다음과 같은 일련의 작업을 Claude 스스로 진행해 준다.

• 요구 사항 청취 (어떤 스킬인지, 언제 발동해야 하는지)
• SKILL.md (스킬 본체의 지시서) 초안 작성 - 간이 검증 (Validation)
• 배포용 .skill 파일로 패키징

채팅에서 「〇〇를 하는 스킬을 만들어줘」라고 의뢰하는 것만으로, Claude가 자동으로 이 skill-creator를 호출하여 작업을 시작한다.

갑자기 구현에 들어가기 전에, 다음과 같은 설계 판단을 해두면 스킬의 질이 올라간다.

• 용도: 무엇을 위해, 어떤 상황에서 사용하는 스킬인가
• 입출력: 무엇을 전달하면, 무엇이 돌아오는가
• 확인이 필요한 조작 유무: 외부 게시·공개 등 되돌리기 어려운 조작을 포함하는 경우 「실행 전에 반드시 확인한다」라는 규칙을 넣어둔다
• 기본적인 안전 측 동작: 망설여진다면 안전한 쪽(이번의 경우 「한정 공유를 기본으로 한다」)을 선택하도록 한다

이러한 부분은 Claude와 대화하면서 다듬어 나가면 빠르다.

스킬의 실체는 SKILL.md라는 하나의 Markdown 파일이다. 서두에 YAML 프론트매터 (YAML front matter)로 스킬의 메타 정보를 쓰고, 그 아래에 절차를 자연스러운 문장으로 써 내려가는 형식이다.

---
name: qiita
description: Qiita에 기술 기사를 게시할 때 사용한다. 사용자가 "Qiita에 게시해줘" 등이라고 말하면 발동한다.
...

포인트는 다음 두 가지다.

• description(설명문)이 발동 조건을 결정한다: Claude는 이 설명문을 보고 「지금 이 대화에서 이 스킬을 사용해야 하는가」를 판단한다. 「Qiita에 게시해줘」와 같은 자연스러운 의뢰 문장에도 반응하도록, 예상되는 말투를 설명문에 포함해 두면 발동하기 쉬워진다.
• 「왜 그렇게 하는지」를 쓴다: 「절대로 확인해라」라고 명령조로 쓰는 것보다, 「Qiita는 공개된 장소이므로 게시 전에 내용을 확인한다」와 같이 이유까지 써 두면, 세밀한 상황 판단이 필요한 장면에서도 Claude가 취지에 맞는 행동을 하기 쉬워진다.

SKILL.md를 작성했다면, skill-creator에 부속된 간이 검증 스크립트로 포맷 오류가 없는지 확인할 수 있다.

python3 -m scripts.quick_validate path/to/your-skill-folder

Skill is valid!라고 나오면 형식적인 문제는 없다.

이것도 부속 스크립트를 통해 스킬 폴더를 ZIP 형식의 .skill 파일로 묶을 수 있다.

python3 -m scripts.package_skill path/to/your-skill-folder ./dist

이렇게 dist/qiita.skill과 같은 파일이 만들어진다.

패키징된 .skill 파일을 Claude가 보내주므로, 표시된 파일 카드(File Card)의 「Save skill」 버튼을 누르면 자신의 프로필에 스킬로서 저장된다.

저장이 완료되면 이후에는 다른 대화를 시작하더라도 「Qiita에 게시해줘」와 같은 의뢰를 하는 것만으로 이 스킬이 자동으로 발동하게 된다.

참고로, 스킬을 저장한 시점에는 현재 진행 중인 대화에는 반영되지 않는다. 이용 가능한 스킬 목록은 대화 시작 시점에 로드되는 구조이므로, 확인하려면 새로운 대화를 시작해야 한다.

• Claude에는 새로운 스킬을 직접 만들기 위한 「skill-creator」라는 스킬이 있다.
• 스킬의 실체는 SKILL.md라는 파일 하나로 이루어져 있으며, 발동 조건은 description에 작성한다.
• 외부 게시와 같이 되돌리기 어려운 조작을 포함하는 스킬은, 실행 전에 확인 과정을 거치도록 설계해 두는 것이 안심할 수 있다.
• 만든 스킬은 .skill 파일로 내보내고, 「Save skill」로 저장하면 이후의 대화에서도 재사용할 수 있다.

자신이 자주 수동으로 수행하는 정형화된 절차가 있다면, 똑같이 「스킬을 만들어줘」라고 부탁해 보자. 그러면 다음부터는 그 절차를 매번 다시 설명할 필요가 없어진다.