Skill로 작업 고정하기
1. Skill로 작업 고정하기
지금까지 인제스트와 린트를 프롬프트로 시켰습니다. 잘 동작하지만 두 가지가 걸립니다. 매번 조금씩 다르게 말하게 되고, 좋은 프롬프트를 만들어도 다음에 다시 쓰기 어렵습니다.
1.1 프롬프트를 저장하는 두 자리
같은 작업을 반복할 때 그 절차를 어디에 둘지 선택지가 둘입니다.
규칙 문서에 둡니다. CLAUDE.md에 적으면 매번 자동으로 읽힙니다. 다만 여기 다 넣으면 파일이 길어지고, 길어지면 뒤쪽 규칙이 흐려집니다.
Skill로 만듭니다. 필요할 때만 불러 쓰는 절차 묶음입니다. CLAUDE.md는 짧게 유지하면서 긴 절차를 따로 둘 수 있습니다.
기준은 이렇습니다. 항상 지켜야 하는 것은 규칙 문서에, 특정 작업을 할 때만 필요한 긴 절차는 Skill에 둡니다.
| 내용 | 어디에 |
|---|---|
| 출처를 문장마다 단다 | CLAUDE.md |
raw/를 수정하지 않는다 | CLAUDE.md |
| 린트 8개 항목 점검 절차 | Skill |
| 회의록 전용 처리 절차 | Skill |
| 분기 보고서 만드는 절차 | Skill |
1.2 Skill 만들기
Claude Desktop에서 입력창 왼쪽의 + 버튼을 누르면 스킬 메뉴가 있습니다. 여기서 새 스킬을 만들 수 있습니다.
만들 내용은 AI에게 초안을 받는 편이 빠릅니다.
지금까지 우리가 린트할 때 쓴 프롬프트들을 모아서
Skill로 만들 절차 문서 초안을 써줘.
- 점검 항목 여덟 개를 순서대로
- 각 항목마다 무엇을 찾고 어떻게 판단하는지
- 결과를 어떤 형식으로 저장할지
- 마지막에 log.md 갱신까지
wiki/lint-checklist.md 의 내용을 바탕으로 하되,
Skill로 쓸 수 있게 절차 형태로 다듬어줘.
받은 초안을 스킬로 등록합니다. 그다음부터는 이렇게 씁니다.
린트 스킬로 위키 점검해줘.
1.3 어떤 작업을 Skill로 만들까
세 번 이상 반복한 작업이 후보입니다.
린트. 항목이 여덟 개를 넘어가면 프롬프트로 매번 쓰기 번거롭습니다.
회의록 인제스트. 일반 인제스트와 절차가 꽤 다릅니다. 결정과 논의를 갈라야 하고, 발언자 처리 규칙이 있고, 상태 문서를 갱신해야 합니다.
주간 정리. 한 주 동안 들어온 자료를 정리하고, 밀린 것을 확인하고, 다음 주 할 일을 정하는 절차입니다.
보고서 출력. 7장에서 다룬 형식으로 위키에서 문서를 뽑아내는 절차입니다.
1.4 Skill 안에 넣을 것
Skill이 프롬프트보다 나은 이유는 길게 쓸 수 있기 때문입니다. 프롬프트로는 부담스러운 것들을 넣습니다.
예시를 넣습니다. 좋은 결과물과 나쁜 결과물을 나란히 보여주면 품질이 확 올라갑니다.
## 좋은 한 줄 요약
국내 온라인 강의 서비스. 14일 무료 체험과 팀 결제 중심.
2026년 8월 팀 최소 인원을 5명에서 3명으로 낮춤.
## 나쁜 한 줄 요약
경쟁사 A에 대한 정보를 정리한 문서입니다.
판단 기준을 넣습니다. "어긋나면 확인 필요로 표시"라는 규칙만으로는 무엇이 어긋남인지 모호합니다.
## 어긋남으로 볼 것
- 같은 항목에 다른 숫자
- 같은 시점에 대한 다른 서술
- 한쪽은 확정, 한쪽은 검토 중으로 적힌 것
## 어긋남으로 보지 않을 것
- 시점이 다른 값 (시간순 기록으로 정리)
- 기준이 다른 값 (기준을 명시하고 둘 다 남김)
- 표현만 다르고 뜻이 같은 것
중단 조건을 넣습니다. 어디까지 하고 사람에게 물어볼지 정합니다.
## 사람에게 물어볼 것
- 문서를 삭제해야 할 때
- 문서 10장 이상을 한 번에 고쳐야 할 때
- 두 자료가 어긋나는데 어느 쪽이 맞는지 판단해야 할 때
1.5 Skill이 잘 안 들을 때
Skill을 만들어도 지시대로 안 되는 경우가 있습니다. 원인이 대개 셋입니다.
너무 깁니다. 절차가 스무 단계를 넘으면 중간이 흐려집니다. 나눕니다. 린트를 '기계적 점검'과 '판단 필요 점검' 둘로 나누는 식입니다.
규칙 문서와 충돌합니다. CLAUDE.md와 Skill이 다른 말을 하면 결과를 예측할 수 없습니다. 한쪽으로 맞춥니다.
추상적입니다. "적절히 판단해서"나 "필요하면"이 들어간 문장은 지켜지지 않습니다. 숫자나 조건으로 바꿉니다.
방금 린트 스킬을 돌렸는데 3번 항목이 제대로 안 됐어.
스킬 문서의 3번 항목에서 어느 부분이 모호한지 짚어주고,
구체적으로 고칠 문장을 제안해줘.
1.6 Skill과 규칙 문서 나누기
시간이 지나면 CLAUDE.md가 길어집니다. 주기적으로 덜어냅니다.
CLAUDE.md 를 검토해줘.
- 항상 지켜야 하는 것 (남길 것)
- 특정 작업에만 필요한 긴 절차 (Skill로 옮길 것)
- 더는 안 쓰이는 것 (뺄 것)
로 나눠서 알려줘.
CLAUDE.md 는 화면 두 쪽 이내로 유지하고 싶어.
규칙 문서를 짧게 유지하는 것이 이 방식의 오래된 요령입니다. AI가 매번 읽는 파일이 짧을수록 그 안의 규칙이 확실히 지켜집니다.
다음 절에서 자료를 손으로 넣지 않고 끌어오는 방법을 다룹니다.