클로드 스킬이 뭔지, 프롬프트랑 뭐가 다른지 정리했습니다

매번 같은 설명을 처음부터 다시 하고 계신다면 스킬을 볼 때가 된 것입니다.

스킬은 그 설명을 파일로 저장해 두고, 필요한 상황에서 알아서 불러 쓰게 만드는 장치입니다.

저희도 반복 작업이 늘면서 이걸 쓰기 시작했습니다.

프롬프트는 그때그때 입력하는 말입니다. 창을 닫으면 사라집니다.

스킬은 파일로 남습니다. 다음에도 같은 절차가 그대로 나옵니다.

더 큰 차이는 부르는 방식입니다.

프롬프트는 사람이 꺼내고, 스킬은 상황이 꺼냅니다

스킬에는 "언제 쓰는 것인지"를 적어 두는 자리가 있습니다.

그 설명과 지금 하려는 일이 맞으면 알아서 불러 씁니다.

그래서 매번 설명하지 않아도 같은 방식으로 일이 진행됩니다.

프로젝트 폴더 안에 `.claude/skills` 를 만들고, 그 아래 스킬 이름으로 폴더를 하나 둡니다.

그 안에 `SKILL.md` 파일을 넣으면 그게 스킬 하나입니다.

폴더를 만들기만 하면 되나요

네, 구조가 맞으면 인식합니다.

프로젝트 폴더에 두면 그 프로젝트에서만, 사용자 폴더에 두면 어느 프로젝트에서나 쓰입니다.

저희는 회사 공통 작업은 사용자 폴더에, 그 프로젝트에만 해당하는 건 프로젝트 폴더에 둡니다.

SKILL.md 머리말

파일 맨 위에 `---` 로 둘러싼 부분이 있습니다. 여기에 설정이 들어갑니다.

`name` 은 스킬 이름입니다. 폴더 이름과 맞춰 둡니다.

`description` 은 이 스킬을 언제 쓰는지 적는 자리입니다.

이 한 줄이 스킬의 성능을 절반 이상 정합니다

여기가 부실하면 만들어 놓고도 안 불려 나옵니다.

description 쓰는 법

"디자인을 도와줍니다" 처럼 뭉뚱그리면 안 불려 나옵니다.

어떤 말이 나왔을 때 이걸 쓰라고 구체적으로 적어야 합니다.

실제로 잘 도는 스킬들을 열어 보면 description 이 아주 깁니다.

다룰 대상을 나열하고, 어떤 상황에서 쓰는지 적고, 언제는 쓰지 말라는 것까지 적혀 있습니다.

쓰지 않을 상황을 적어 두는 게 특히 도움이 됩니다.

엉뚱한 자리에서 불려 나오는 걸 막아 줍니다.

머리말에 `user-invocable: true` 를 넣으면 슬래시로 직접 부를 수 있습니다.

`/스킬이름` 을 치면 그 스킬이 실행됩니다.

상황에 맡기지 않고 내가 정할 때 씁니다.

네, 직접 부를 수도 있고 상황에 따라 알아서 불릴 수도 있습니다.

자주 쓰는 작업은 이걸 켜 두면 편합니다.

`allowed-tools` 로 그 스킬이 쓸 수 있는 도구를 정할 수 있습니다.

예를 들어 특정 명령만 실행하게 제한하는 식입니다.

넓게 열어 두는 것보다 좁혀 두는 편이 안전합니다

파일을 지우거나 외부로 내보내는 작업이 섞인 스킬이면 특히 그렇습니다.

내용이 길어지면 SKILL.md 하나에 다 넣지 않습니다.

`reference` 같은 하위 폴더를 만들어 참고 문서를 나눠 담습니다.

SKILL.md 에는 무엇을 언제 읽으면 되는지만 적어 둡니다.

필요한 문서만 그때 읽는 구조가 훨씬 가볍습니다.

실행할 스크립트가 있으면 `scripts` 폴더에 따로 둡니다.

저희는 반복되는 작업을 스킬로 옮기고 있습니다.

블로그 글을 검토하는 기준, 홈페이지를 점검하는 순서 같은 것들입니다.

한 번 정리해 두면 담당자가 바뀌어도 같은 기준으로 돌아갑니다.

어디부터 만들면 좋을까요

같은 설명을 세 번 이상 한 작업부터 옮기시면 됩니다.

그게 제일 빨리 값을 합니다.

처음에는 하나만 만들어 보시는 걸 권합니다.

여러 개를 한 번에 만들면 어느 것이 언제 불려 나오는지 헷갈립니다.

하나를 며칠 써 보고 description 을 고치는 과정이 필요합니다.

저희도 첫 스킬은 세 번쯤 고쳤습니다.

만들었다고 끝이 아닙니다. 실제로 불려 나오는지 확인해야 합니다.

그 상황을 만들어 놓고 한 번 시켜 봅니다.

안 불려 나오면 description 이 문제인 경우가 대부분입니다.

어떤 말이 나왔을 때 쓰라는 건지 다시 적습니다

반대로 엉뚱한 자리에서 불려 나오면 범위가 너무 넓은 것입니다.

쓰지 말아야 할 상황을 한 줄 추가하면 대부분 잡힙니다.

내용이 길어졌으면 참고 문서로 빼냅니다.

얼마나 길면 빼야 하나요

한 화면에 안 들어오면 그때 나눕니다.

만들다 막히시면 상담 주셔도 됩니다. 저희도 같은 자리에서 헤맸습니다.

#클로드코드 #클로드스킬 #AI자동화 #업무자동화 #개발도구 아비컴퍼니 드림