Claude Code 스킬을 만들기 시작하며 깨달은 함정 ── 2분 만에 만들 수 있지만, 단 한 가지 질문에 먼저 답하라

스킬 (Skills)을 처음에 몇 개 만들어 보면 보람이 느껴집니다. 매번 마감 작업이 한 번에 정리됩니다. 세션 시작 시의 현재 위치가 순식간에 복구됩니다. 감동하여 차례차례 만들고 싶어지지만, 어느샌가 비슷한 스킬이 난립하여 "어떤 것을 사용할지" 고민하기 시작합니다.

역할이 다른 4명의 사용자에게 인터뷰한 결과, 전원이 동일한 지점에서 실패하고 있었습니다.

그 질문이란:

그 작업은 다음번에도 동일한 절차로 재현할 수 있는가?

YES라면 → 2분 만에 만들 수 있습니다 (후술)

NO라면 → 만들어도 망가집니다 (그 이유를 먼저 읽어주세요)

NO의 이유: 판단을 틀(Template)에 넣으면 망가진다

먼저 "NO"에 대해 이야기하겠습니다. 망가지는 이유를 알고 나서 만드는 편이 더 빠릅니다.

실패 사례 1: 여러 페이즈 (Phase)를 총괄하는 스킬을 만들려다 과잉 설계에 빠져 포기. 총괄이나 우선순위 판단은 그 에이전트 (Agent)의 핵심 가치 그 자체이며, 절차로 떨어뜨릴 수 있는 것이 아니었습니다.

실패 사례 2: 브레인스토밍 (Brainstorming)의 발산 프로세스를 스킬로 고정했다. 매번 동일한 단계로 생각하게 했더니, 나오는 아이디어가 동일한 패턴으로 수렴하여 발산의 의미가 사라졌습니다. "각도가 죽었다"라는 표현이 딱 어울렸습니다.

4명 전원이 겪은 실패의 핵심은 같습니다. "판단"을 틀에 넣는 순간 망가집니다.

스킬이 효과를 발휘하는 것은 "배관"뿐입니다. 매번 동일한 순서로 움직이는 준비 단계 (마감 절차, 기록, 정형 체크)를 고정합니다. "무엇을 생각할지"는 고정하지 않습니다.

YES의 경우: 2분 만에 만들 수 있다

작업이 끝난 직후에 그대로 붙여넣어 사용할 수 있습니다.

방금 수행한 일련의 절차를, 다음부터 한 번에 호출할 수 있는 스킬로 만들어줘.
description (무엇을 하는 스킬인지)은 "배포 전 체크를 실행한다"로 해줘.

AI가 절차를 정리하여 .claude/skills/<이름>/SKILL.md를 만듭니다.

직접 쓸 필요는 없습니다.

만든 후에는 Claude Code의 세션에서 "리뷰해줘"와 같이 평범하게 부탁하면 자동으로 사용됩니다. 확실하게 호출하고 싶을 때는 /배포전체크와 같이 스킬 이름을 직접 지정할 수 있습니다.

description만 정성스럽게 작성합니다. 실행 여부는 여기서 결정됩니다.

# 좋음
description: 배포 전 체크를 실행한다
# 나쁨
...

모호하면 필요한 상황에서 호출되지 않고 사장됩니다.

요약

착수 전 한 가지 질문.

"그 작업은 다음번에도 동일한 절차로 재현할 수 있는가?"

YES → 지금 바로 "이거, 스킬로 만들어줘"라고 부탁하세요. 2분이면 끝납니다.

NO → 고정하지 않습니다. 그 판단은 스스로 계속 쥐고 있습니다.

Discussion