Claude Code 커맨드가 skills로 통합된 뒤, 내 커스텀 커맨드는 안전할까

도입

어느 날 타임라인에 "슬래시 커맨드가 이제 skills로 통합되었다"는 글이 돌아다니는 걸 보고 잠깐 머리가 복잡해졌습니다. 저는 .claude/commands/ 폴더에 커밋 메시지 생성과 PR 생성용 커스텀 슬래시 커맨드를 두고 쓰고 있었기 때문입니다. 당장 메이저 버전업을 해야 하는건지, 아니면 그냥 놓아도 되는 건지 확인이 필요해 직접 찾아봤습니다.

먼저 바로잡을 것: "정책 변경"이 아니라 "통합"

찾아보니 이건 기존 커맨드를 강제로 막는 정책 변경이 아니었습니다. Claude Code v2.1.3부터 .claude/commands/deploy.md 파일과 .claude/skills/deploy/SKILL.md 폴더가 동일하게 /deploy 명령어를 만드는 구조로 통합된 거였습니다. 기존 커맨드 파일을 삭제하거나 이관해야 한다는 공지는 없었고, 폐지 예고일자도 정해진 게 없었습니다.

즉 제 .claude/commands/commit.md와 .claude/commands/create-pr.md는 아무것도 안 해도 그대로 쓸 수 있다는 이야기입니다.

그럼 무엇이 달라지는 건지

skills 형식(.claude/skills/<이름>/SKILL.md)만이 가진 차이점들을 정리하면 다음과 같습니다.

• 자동 호출: 슬래시 커맨드는 사람이 /명령어를 직접 입력해야만 실행되지만, skill은 frontmatter의 description을 보고 Claude가 스스로 판단해 호출할 수 있습니다.
• 부가 파일 포함: commands는 단일 마크다운 파일만 가능하지만, skills는 같은 폴더에 참고 파일을 함께 둘 수 있습니다.
• 타 툴 호환성: SKILL.md 형식은 Agent Skills 공개 표준을 따르기 때문에, 동일 파일이 다른 도구에서도 인식될 여지가 있습니다 (어느 도구까지 지원하는지는 도구별로 다를 수 있으므로 [도구별 지원 여부 확인 필요]).
• 둘 다 지원하는 기능도 있습니다. 사전 셸 명령어 결과를 프롬프트에 삽입하는 방식은 commands와 skills 모두에서 동일하게 쓸 수 있었습니다.

내 프로젝트에 대입해본 결과

지금 당장 마이그레이션해야 하는 이유는 없다는 것을 확인했습니다. 기존 커밋/PR 생성용 커스텀 명령어는 사람이 직접 /commit, /create-pr 같은 식으로 호출하는 구조로 동작하고 있었고, 자동 호출이나 타 도구 호환성이 당장 필요한 상황이 아니었기 때문입니다. 다만, 코드 리뷰가 서브에이전트에서 분리되어야 할 작업처럼 서브에이전트/자동호출이 필요해지는 경우에는 skill 형식이 더 적합해 보입니다.

주의할 점

마이그레이션을 결정하기 전에 확인해둘 만한 것들입니다.

• 같은 이름의 command와 skill이 동시에 존재하면 skill이 우선합니다.
• 새 최상위 skills 디렉토리를 추가하면 재시작이 필요할 수 있습니다 (기존 skill 수정은 재시작 없이 적용된다고 함).
• description과 when_to_use 항목은 길이가 함께 제한된다는 보도가 있었으므로 [정확한 제한 길이는 공식 문서로 재확인 필요], 짧게 유지하는 편이 안전해 보입니다.

마무리

제목만 보고 "내 커맨드가 위험해졌나" 하고 걱정했던 마음과 달리, 실제로는 통합으로 인해 기존 커맨드가 위험해진 것은 아니었습니다. 다만 이번에 찾아보면서 skill 형식이 제공하는 자동호출과 타 도구 호환성이 제 워크플로우에 언젠가 필요해질 수 있겠다는 건 알게 됐습니다. 당장은 아니더라도, 한번은 들여다보고 지나가기로 했습니다.

---

[핵심요약] Claude Code 커맨드↔스킬 통합, 내 커스텀 커맨드는 안전하다