Anthropic가 오늘 Claude Code, Claude.ai, Claude API 전반에 퍼스트파티 Skills 시스템을 출시했다. 글쓴이는 Superpowers를 이에 맞춰 업데이트하며 공식 스킬 구조와 배치, 자동 사용, LLM의 자가 스킬 생성, TDD 지향, 그리고 향후 계획을 공유한다.
Anthropic가 오늘 Claude Code, Claude.ai, Claude API 전반에 걸쳐 자사 퍼스트파티 Skills 시스템을 출시합니다. 꽤 오랫동안 준비해 온 게 느껴지고, 정말 기대됩니다.
몇 분 안에 공식 Skills 시스템을 사용하는 Superpowers의 새 버전을 릴리스할 예정입니다. 이 글을 처음 게시한 직후, 공식 Skills 시스템을 사용하는 Superpowers의 새 버전을 릴리스했습니다.
테스트할 수 있도록 친절히 사용 권한을 준 새 스킬 중 하나는 새로운 'creating MCPs' 스킬입니다. 생성되는 도구 설명이 다소 장황하다는 작은 문제를 빼면, 지금까지 경험한 MCP 개발 중 단연코 가장 매끄러웠습니다. (곧 공개하고 싶은 Claude Code용 새로운 에피소딕 메모리 플러그인에 들어갈 'search' 도구를 만드는 데 사용했습니다.)
지난 한 달 가까이 Claude Code에서 스킬을 사용해 왔습니다. 지난주 Anthropic이 Claude Code에 플러그인 지원을 내놓자, 이를 기념해 제가 직접 만든 스킬 시스템을 Superpowers for Claude Code로 공개했습니다.
Superpowers는 몇 가지로 이뤄져 있습니다:
SKILL.md 파일을 로드하고 언제 사용할지 학습하도록 하는 부트스트랩. SKILL.md 파일, 검색 도구, 시작 시 초기화 훅으로 구성됩니다.SKILL.md 파일을 만들고, 관리하고, 공유하도록 설계된 SKILL.md 파일 모음.Architect/Implementer 에이전틱 코딩 방법론을 담은 SKILL.md 파일 모음으로, 브레인스토밍부터 TDD 과정 전체를 아우릅니다.SKILL.md 파일 모음.주말 동안 최종 사용자로부터의 버그 리포트를 검토하던 중, claude --debug에서 'skill' 파일과 'skills' 디렉터리에 관한 로그 출력이 잔뜩 보였습니다. 스킬 시스템을 디버깅 중이었으니 당연해 보였죠.
문제는 그 로그가 Superpowers에서 나온 것이 아니었다는 점이었습니다. (약간 웃긴 얘기지만, 그 로그가 Superpowers의 것인지 확인해야 했습니다. Superpowers의 실제 구현은 전부 Claude가 했기 때문에, 그 부분 코드를 직접 본 적이 없었거든요.)
저는 Anthropic의 초기 MS Office 스킬 몇 가지를 파고들며 여기저기서 부품을 조합하고, 해보고 싶었던 약간 별난 아이디어를 섞어 Superpowers의 코어 스킬 시스템을 만들어냈습니다.
그때만 해도 Claude Code 안에 사실상 완성된 스킬 시스템 구현이 숨어 있다는 걸 전혀 몰랐습니다. Anthropic의 문서에 따르면, 퍼스트파티 스킬 시스템은 Claude Code 2.0.0에 일부 지원이 있고, 어쩌면 Claude Code 1.0 시절부터 있었던 것 같기도 합니다!?
만약 Claude Code에 이미 '메타데이터만 제대로 갖추면 SKILL.md 파일을 유용하게 만드는' 그 마법 같은 부트스트랩 요소가 있었다는 걸 알았더라면, 굳이 제 것을 만들진 않았을 겁니다.
하지만 이제 Skills가 공식 기능이 되었으니, Superpowers도 그 미래를 기꺼이 받아들입니다.
공식 스킬 시스템에 익숙해지면서 보니 가장 큰 설계 차이는, Anthropic의 스킬에는 name, description, license(아마도?), 그리고 metadata 필드가 있다는 점입니다. 우리의 스킬은 전면 데이터가 유연했지만 핵심은 name, description, 그리고 when_to_use였습니다. 우리는 'Claude가 이 스킬을 언제 써야 하는가?'와 '이 스킬이 무엇을 하는가?'의 답을 분리했죠. 저는 여전히 그 구분이 중요하다고 생각합니다. 테스트해 보니 'Claude가 이 스킬을 언제 써야 하는가?'만 보여줄 때 준수율이 더 좋았습니다. Claude가 스킬이 무엇을 하는지 안다고 믿으면, 아직 읽지 않았더라도 스스로 사용 중이라고 생각하고 즉흥적으로 처리하려는 경향이 커지거든요.
저는 코어 스킬들을 Anthropic 방식으로 전환해 다시 썼습니다. 그리고 코어 스킬을 핵심 Superpowers 스킬과, Microsoft의 Amplifier에서 배운 스킬 묶음으로 분리했습니다.
아직 Anthropic의 스킬을 충분히 다뤄 보지는 못했고, 대부분은 Claude.ai에서 살펴봤습니다.
탐색을 하면서 가장 흥미로운 부분은 LLM이 스스로 자신의 스킬을 만들게 하는 것입니다. 이것이 잘 작동하면 에이전트의 자기개선을 위한 여러 경로의 핵심이 됩니다.
제가 보기엔 Anthropic의 스킬 생성 방법론은 제 것과 꽤 다릅니다. Anthropic의 스킬 생성 메타스킬 내부를 들여다보기보다는, 2025년의 좋은 엔지니어라면 할 일을 했죠: 제 writing-skills/SKILL.md를 Claude.ai에 업로드하고, Anthropic의 퍼스트파티 스킬 생성 메타스킬과 비교·대조해 달라고 요청한 뒤 커피를 한 잔 하러 갔습니다.
돌아와 보니 두 접근법을 비교·대조한 꽤 자세한 보고서가 있었습니다. 그들의 스킬은 스킬 생성의 디테일을 훨씬 더 촘촘히 다루고, 복사해 쓸 수 있는 템플릿을 포함합니다. 제 것은 스킬을 테스트하는 데 훨씬 더 많은 시간을 쓰고, Claude가 왜 스킬을 쓰지 않아도 된다고 합리화하는지를 피하는 방법과, 준수를 보장하도록 돕는 설득 기법에 집중합니다.
예상대로, Claude는 TDD의 팬입니다.
Claude Code에서 Skills는 다음 위치에 포함된 SKILL.md 파일입니다: ~/.claude/skills/ 내부 디렉터리, 프로젝트 디렉터리의 .claude/skills, 그리고 플러그인의 skills 하위 디렉터리.
현재로서는, Skills가 /command로
스킬 자체도, 명령 실행을 비활성화하는 프런트매터 플래그가 없는 도구에 대해서는 /command를 실행할 수 있습니다.
스킬은 어떤 플러그인의 skills/ 디렉터리에도 포함될 수 있습니다.
이 모든 것에서 정말 웃긴 점 하나는, 사용자들이 커스터마이즈하고 개선 사항을 공유하기 쉽도록 다른 git 저장소로 옮기기 전까지, Superpowers의 스킬을 제가 정확히 그 위치에 넣어두었다는 겁니다.
Claude Code는 모든 스킬을 자동으로 시스템 프롬프트에 인덱싱합니다. 장차 일부 스킬을 즉각적으로 노출하지 않도록 숨길 수 있게 해주길 바랍니다. 그러면 '디버깅'처럼 추가 스킬에 링크하는 더 복잡한 '복합' 스킬을 만들 수 있을 테니까요.
지난 며칠간 이 용감한 새 세계에 맞춰 우리 스킬을 정비하는 데 시간을 썼지만, 아직 완전히 준비되진 않았습니다. 새 시스템은 (아마) 세션 시작 훅, 스킬용 별도 git 저장소, 그리고 find-skills 도구를 없애줄 겁니다. 이제 스킬이 서브에이전트 페르소나나 /command처럼 관리될 수 있으니, Superpowers가 자체 플러그인 시스템을 만들거나 방대한 스킬 모노레포가 될 필요가 없습니다.
스킬은 믿을 수 없을 만큼 강력합니다. 직접 지시하지 않아도 에이전트의 행동을 다르게 만드는 주문 같은 말이죠. 스크립트와 바이너리를 묶을 수도 있습니다(제 생각엔 여전히 일반적인 도구 사용 승인 절차를 거쳐야 합니다). 스킬은 프롬프트 인젝션에 취약한 것을 넘어서—스킬 자체가 프롬프트 인젝션의 정의이기도 합니다. (엠대시와 "X가 아니라 Y다" 구문에도 불구하고, 저 문장은 100% 인간이 쓴 겁니다. 아주 늦은 밤이긴 했지만요.)
사용자가 무언가를 만들거나 코딩하려 한다고 감지할 때, 브레인스토밍 스킬을 항상 자동으로 실행하도록 Claude를 설득하는 문제를 아직 해결 중입니다.
Claude Code는 스킬을 자동으로 사용해야 한다는 걸 알지만, 제 환경에서는 아직 신뢰할 만하지 않습니다. 적어도 당분간은 'using-skills' 스킬을 새로운 'using-superpowers' 스킬로 바꾸고, Claude Code가 시작될 때 로드되도록 Superpowers의 세션 시작 훅을 업데이트했습니다. 새 시스템에 익숙해지면 그 shim을 제거할 수 있길 기대합니다.
나중에 Claude Code에 더 이상 필요하지 않더라도, using-superpowers/SKILL.md는 gemini-cli와 codex에서 아주 잘 동작할 겁니다. 그렇게 되면, 이들 역시 SKILL.md 스킬의 새로운 세계를 누릴 수 있겠죠.
그 외 플랫폼용 스킬도 작업할 시간을 찾고 싶지만, 여러분(그래요, 바로 여러분)이 저보다 먼저 해주고 그 기능을 Superpowers에 기여해 주신다면 정말 감사하겠습니다.