13. 마음에 든 작업을 나만의 스킬로 만들기
수료증 하나에서 시작했습니다
개인 세션에 참여한 분이 수료증을 만들어줄 수 있느냐고 물었습니다.
‘어디에 쓰시려고요?’
회사에 제출해서 교육비 지원을 받을 수 있는지 문의하려는 목적이었습니다. 그러면 어떤 문서가 필요한지 이해할 수 있겠죠. 저는 Claude Code에 그 이유를 설명하고, 디자인 가이드를 참고해 수료증을 만들게 했습니다.
처음 나온 모습이 그대로 완성본이 된 것은 아닙니다. 모양을 맞추고 결과를 고쳐 PDF로 만들어 전달했습니다.
그다음에 생각했습니다. 이런 요청이 또 올 수도 있겠다.
그래서 방금 함께 한 과정을 스킬로 만들게 했습니다. 나중에 다른 분이 수료증을 요청했을 때 다시 사용할 수 있는 방식으로요.
처음부터 ‘수료증 발급 시스템을 설계하자’고 시작한 것은 아닙니다. 실제로 필요한 일을 하고, 결과를 맞춘 뒤, 반복할 방법을 남겼습니다.
먼저 결과를 만듭니다
앞 글에서는 스킬이 업무의 순서와 판단, 예외를 담는 지침이라고 설명했습니다. 그렇다고 그 내용을 처음부터 혼자 다 써야 하는 것은 아닙니다.
원하는 결과부터 이야기하면 됩니다. 수료증이라면 이름을 넣는 것만으로 끝나지 않습니다. 어떤 과정인지, 기간은 언제인지, 발급 주체는 누구인지, 수료를 확인할 자료는 무엇인지 알아야 합니다. 제출 목적에 맞는 항목과 표현도 봐야 하고요.
AI가 모르는 부분을 질문하고, 자료를 확인하고, 초안을 만들게 합니다. 저는 결과를 보고 고칩니다. 빠진 항목이 있는지, 문구가 사실과 맞는지, 실제로 제출할 수 있는 문서인지 판단하는 겁니다.
자기 일에서도 같은 순서로 하면 됩니다. 보고서를 만들다가 ‘이 항목을 맨 앞에 보여줘’, ‘확인되지 않은 숫자는 따로 빼줘’라고 고쳤다면, 그런 판단이 스킬에 남길 재료입니다.
Step 1. 반복할 부분을 정리하게 합니다
만족한 결과가 나왔다면 이렇게 요청할 수 있습니다.
방금 한 작업을 앞으로도 반복할 것 같아.
어떤 자료를 확인했고, 어떤 순서와 기준으로 결과를 맞췄는지 정리해줘.
매번 달라지는 입력과 계속 유지할 기준을 나눠서,
스킬로 만들기 전에 내가 확인할 수 있게 보여줘.
완성 파일을 복사하는 것과 과정을 남기는 것은 다릅니다. 수료증의 이름과 날짜는 바뀝니다. 수료 여부를 확인해야 한다는 기준은 남아야 합니다.
‘지금 이름을 다음 사람 이름으로 바꿔줘’에만 머무르면, 지난 사람의 기간이나 과정 정보까지 그대로 남을 수 있습니다. 무엇이 바뀌고 무엇을 다시 확인해야 하는지 구별해야 하죠.
Step 2. AI에게 스킬 구성을 맡깁니다
내용이 맞으면 현재 공식 형식을 확인해 스킬로 만들게 합니다.
이 기준으로 스킬을 구성해줘.
현재 Claude Code 공식 스킬 가이드를 확인하고,
필요한 입력, 작업 지침, 참고 자료와 실행 도구를 나눠줘.
기존 스킬과 겹치는지도 보고, 어디에 둘지 설명한 뒤 만들어줘.
독자가 폴더 경로와 YAML을 외워 직접 작성할 필요는 없습니다. AI가 구성하고, 제가 내용을 설명받아 확인하면 됩니다.
스킬을 모든 개인 작업에서 쓸지, 특정 프로젝트에서만 쓸지도 이야기합니다. 사용자 스킬은 ~/.claude/skills/, 프로젝트 스킬은 .claude/skills/ 아래에 놓을 수 있습니다. 이 위치는 적용 범위를 설명하는 것이며 직접 입력하는 숙제가 아닙니다. 현재 스킬 가이드
SKILL.md에는 무엇이 들어가나요?
아래는 수료증 업무의 구성을 이해하기 위해 새로 만든 공개 최소 예시입니다. 제 실제 발급 스킬이나 디자인을 그대로 옮긴 것은 아닙니다.
---
name: certificate-practice
description: 확인된 교육 이수 자료로 제출 목적에 맞는 수료증 초안을 만들 때 사용한다.
---
# 수료증 초안 만들기
1. 제출 목적과 필요한 항목을 확인한다.
2. 이름, 과정명, 교육 기간, 발급 주체, 수료 확인 자료를 확인한다.
3. 빠진 정보는 질문하고, 확인되지 않은 수료 사실이나 날짜를 만들어 넣지 않는다.
4. 확인한 내용으로 초안을 만들고, 문구와 모양을 함께 검토한다.
5. 파일을 생성했다면 내용 누락과 잘림이 없는지 열어서 확인한다.
6. 결과 파일의 위치와 아직 확인할 사항을 알려준다.
name은 스킬 이름이고, description은 어떤 작업에서 사용할지 설명합니다. 본문에는 실제로 할 일과 판단 기준을 적었습니다. ‘수료증’이라는 단어 하나만 맞추는 것보다, 확인된 자료로 제출용 문서를 만드는 상황이 드러나는 게 좋습니다.
현재 Claude Code는 메타데이터 필드를 선택 사항으로 허용하고 description을 권장합니다. 공통 Agent Skills 규격은 name과 description을 필수로 정합니다. 이 예시는 두 필드를 포함한 기본 형식입니다. 공통 형식 안내
특히 세 번째 절차를 보세요. 기간을 모르면 오늘 날짜로 채우는 게 아니라 질문하도록 했습니다. ‘초안에서는 미확정 항목을 표시하고 파일 생성은 기다린다’로 바꾸면 진행 방식도 달라질 수 있습니다. 실제 결과가 기준대로 달라지는지는 써보며 확인합니다.
권한 설정을 추가할 때도 의미를 알고 넣어야 합니다. 예를 들어 allowed-tools는 해당 스킬을 호출한 턴의 사전 승인입니다. 그 밖의 도구를 모두 막는 제한 목록이 아닙니다. 위 최소 예시에는 넣지 않았습니다.
매번 달라지는 정보는 따로 받습니다
다음은 설명용 가상 입력입니다. 실제 참여자나 실제 이수 증빙이 아닙니다.
{
"recipient": "김예시",
"program": "업무 개선 실습",
"period": {
"start": "2026-10-01",
"end": "2026-10-15"
},
"issuer": "예시 교육팀",
"purpose": "회사 제출",
"completion_source": "가상 이수 확인표"
}
recipient는 대상자, program은 과정, period는 기간입니다. issuer는 발급 주체이고, completion_source는 수료 여부를 확인할 자료를 가리킵니다. 여기에 자료 이름을 적었다고 수료 사실이 증명되는 것은 아닙니다. 실제 자료에서 대상과 이수 여부를 확인해야 합니다.
이 값들을 독자가 직접 JSON으로 써야 하는 것은 아닙니다. 대화나 기존 자료에서 AI가 정리할 수 있습니다. 이렇게 구분해보면 이번 사람과 이번 과정에서 다시 확인할 정보가 무엇인지 보입니다.
지침과 디자인, PDF 생성은 다른 역할입니다
SKILL.md를 썼다고 PDF를 만드는 기능이 저절로 생기지는 않습니다. 문서의 내용과 배치, 실제 파일을 만드는 도구는 구별해야 합니다.
필요하다면 이런 역할로 나눌 수 있습니다. 아래는 설명용 구조이며, 이 이름의 레이아웃과 실행 프로그램을 여기서 제공하는 것은 아닙니다.
certificate-practice/
├── SKILL.md ← 확인할 정보와 제작·검토 절차
├── assets/
│ └── layout.html ← 글과 로고 등을 어디에 놓을지 정한 배치
└── scripts/
└── render.py ← 입력과 배치를 받아 PDF 파일을 만드는 도구
이 구조를 선택한다면, 매번 달라지는 정보를 레이아웃에 맞춰 넣고 렌더러가 파일을 만듭니다. SKILL.md는 필요한 정보가 확인됐는지, 어떤 도구로 만들지, 결과를 어떻게 검사할지를 안내합니다.
다만 HTML이나 Python만 써야 하는 것도 아닙니다. 이미 쓰는 문서 도구나 설치된 변환 프로그램을 사용할 수 있습니다. 어떤 구현이 자기 환경에 맞는지는 AI가 확인하고 구성하게 하면 됩니다. 스크립트와 자산은 필요할 때 두는 구성이지 모든 스킬에 반드시 있어야 하는 파일이 아닙니다.
이름이 긴 사람의 문서에서 글자가 잘린다면 내용만의 문제가 아닐 수 있습니다. 배치나 생성 도구를 고쳐야 합니다. 반대로 수료 여부를 확인하지 않고 문서를 만들었다면 입력 확인과 판단 기준부터 봐야 합니다. 역할을 구별하면 무엇을 수정할지 설명하기 쉽습니다.
Step 3. 발견과 호출, 결과를 나눠 확인합니다
저장했다고 완성은 아닙니다. AI에게 검증도 맡깁니다.
만든 스킬을 확인해줘.
스킬 목록에서 발견되는지, 실제로 호출되는지,
가상 입력으로 만든 결과가 요청한 항목과 기준을 지키는지 나눠서 봐줘.
빠진 정보가 있을 때 추측해 채우지 않는지도 확인해줘.
먼저 파일이 있는지와 Claude Code가 스킬로 발견했는지를 구별합니다. 일반 세션에서는 /skills로 목록을 볼 수 있고, 직접 /certificate-practice로 호출해볼 수도 있습니다. 실제로 구성했을 때의 이름입니다. 예시를 읽은 것만으로 이 스킬이 설치된 것은 아닙니다.
기존 스킬의 변경은 감시되는 폴더에서 세션에 반영됩니다. 세션을 시작할 때 없던 최상위 스킬 폴더를 새로 만들었다면 /reload-skills로 다시 불러옵니다. 그 폴더가 감시되지 않는 세션에서는 이후 변경 때도 다시 불러와야 합니다. 안 보인다면 무조건 같은 파일을 또 만들기보다 위치와 이름, 현재 세션의 발견 상태를 확인합니다. 작성 중 스킬 변경과 반영
다음에는 실제 호출과 결과를 봅니다. 이름으로 불렀을 때만 되는지, 설명한 업무를 자연어로 요청해도 적절히 선택되는지 확인할 수 있습니다. 특정 단어를 적었다고 반드시 선택되는 것은 아닙니다.
마지막으로 원한 결과가 나왔는지 봅니다. 가상 입력을 바꿔 이름과 기간이 섞이지 않는지, 정보 하나를 빼면 질문하는지, 긴 이름에서도 결과가 잘 보이는지 확인합니다. PDF를 만들었다면 파일이 있다는 것에서 끝내지 않고 열어서 내용과 화면을 같이 봐야 합니다.
AI가 ‘완료’라고 말한 것과 실제 요청을 충족한 것은 다릅니다. 입력 자료, 요청한 항목, 만들어진 결과를 함께 놓고 대조하게 하면 됩니다.
Step 4. 쓰면서 고칩니다
처음 만든 스킬에 모든 예외가 들어갈 수는 없습니다. 다른 입력에서 문제가 나오면 그 차이를 알려주면 됩니다.
‘이 사람은 이름이 길어서 잘렸어. 배치를 조정해줘.’
‘기간이 빠졌는데 임의로 날짜를 넣었어. 없으면 질문하도록 고쳐줘.’
기준을 바꾼 뒤에는 같은 문제가 있었던 입력과 다른 입력을 함께 확인합니다. 수정한 파일을 다시 봤다는 것만으로 결과까지 고쳐졌다고 판단하지 않는 겁니다.
수료증이 아니어도 같습니다. 회신 초안, 보고서, 엑셀 정리처럼 결과를 맞춰본 일이 있다면 그 과정에서 반복할 판단을 찾을 수 있습니다.
일을 먼저 하고, 마음에 드는 결과를 만든 뒤, 다음에도 쓸 방법으로 남깁니다. 제가 스킬을 만드는 순서입니다.
다음으로는 서브에이전트에게 일을 나눠 맡기는 이야기를 보겠습니다. 기존 번호로는 8편입니다. 사이트의 발행일 기준 자동 ‘다음 글’은 14편 웹 수집으로 이어지지만, 기본 학습은 스킬 다음에 서브에이전트로 넘어가는 순서를 권합니다.