SPACE LOGBOOK

OCEAN LOGBOOK

Claude Code Skills

2026.03.06

Claude Code Skills

2026.03.06

클로드 코드에 스킬.. 이라는 것이 있다.. 프로젝트 스킬 또는 사용자 스킬로 쓰이는데… 용어만 어려워 보이지 이건 별게 아니다. 프로젝트 스킬은 특정폴더 내에서 그 작업에만 쓰이는 스킬.. 사용자 스킬은 그냥 일반적으로 아무데서나 불러 들이면 쓸 수 있는 스킬…
스킬이라는 건.. 사전 정의된 설명서와 같아서 반드시 파일의 저장형식이.. skill.md 이어야 한다.

저장경로 ..프로젝트 스킬의 경우 – C:\Test\skills\capital-gains-review\
저장경로 ..사용자 스킬의 경우 – C:\Users\user.claude\skills\-capital-gains-review\

그럼 스킬(skill)이 뭐냐… 이게 가장 중요한데.. 난 처음에는 스킬? 기술?.. 음.. 스킬이 뭐야..싶어서 여러 유튜버들의 강의를 찾아 보았다.. 대여섯개의 강의를 보고나서도 .. 도대체 뭔 소리여? “스킬은 에이전트의 컨텍스트 윈도우에 프로그레시브 디스클로저 방식으로 메타데이터를 인젝션하여 LLM의 퍼포먼스를 엔핸스하는…$$$%&&### ” 앤트로픽에서 영어로 써놓은 원문 복사해다가 한글로 해석하면서 뭔 귀신 씨나락 까먹는 소리하고 자빠져 있는 애들도 상당히 많이 보이더라구…
갈수록 미궁에 빠져들어가는 게 답답해서.. 직접 내가 만들어서 해보기로 했다.. 그리고 해 본 결과…

스킬이란….

자.. 예를들어 “홍길동 양도세 계산해줘” 라고 명령을 내리면.. 똑같은 명령을 내려도 오늘 , 내일.. 그리고 일주일 후 출력되는 결과값과 출력양식이 달라진다… 오늘은 A라는 모양으로 답을 했다가.. 내일은 B라는 모양으로 답을 하고..
등등.. 똑같은 질문에 답변형식은 일관성도 없고 유사성도 없을 수 있게 된다..
이 때 skill.md에 어떠한 형식으로 답변이 나와야 하는지.. 어떤 점을 고려할 것을 빠뜨리지 말 것을.. 등등 일반적이고 객관적인 형태로 적어 놓으면.. 그게 바로 스킬이 된다.

따라서 홍길동 양도세 계산해줘..라고 오늘 명령을 내려도.. 내일 명령을 내려도.. 똑같은 형식에 일정한 모양으로 같은 대답이 출력된다.

결국 스킬의 본질은 “내가 원하는 방식대로 일하라고 써놓은 업무 매뉴얼”.. 인 것이었다.
따라서 A폴더에는 A라는 내용의 skill.md를 만들어 놓고.. B폴더에는 B라는 skill.md를… 이런식으로 열개의 폴더에 열개의 md를 만들어 놓으면.. 결국..나는 10명의 보조수행원을 두고 있는 것과 마찬가지인 효과를 얻게 되는 것이다.

내가 직접해보고 어느 정도 이해하고 나니.. 처음에 장황한 소리로 영어 원문을 유창하게 읽어가면서 한영 혼용 구어체로 떠들던 유튜버 들은 실제로 해보기는 한걸까?.. 뭘 업무처리를 해보고 알고 떠드는 소리일까?..라는 생각이 들었다.. 스킬은 일정한 출력값을 얻기 위한 사전 지시 메뉴얼.. 즉, A한테 시켜도 B한테 시켜도 똑같은 보고서를 들고 들어오게 만드는 그런 것이다.. 어렵게 이해하지 말자…

댓글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다

이 기록은 여기까지지만,
생각은 아직 이동 중이다