Cmd. /skills
사용 가능한 skill 목록을 보고, 토큰 기준으로 정렬하거나 특정 skill을 숨기는 명령
핵심 요약
/skills는 현재 세션에서 쓸 수 있는 skill 목록을 보여주는 내장 명령으로, bundled skill이 아닙니다.- 메뉴에서
t로 토큰 수 정렬,Space로 skill 숨김 전환,Enter로 저장하며, 결과는.claude/settings.local.json의skillOverrides에 기록됩니다. - 같은 이름이 skill과 명령으로 동시에 존재하면 skill이 우선합니다.
- 동일 이름이 여러 위치에 있으면 enterprise → personal → project 순으로 재정의되고, 플러그인 skill은
plugin-name:skill-namenamespace를 씁니다. - 부작용이 큰 skill은 SKILL.md에
disable-model-invocation: true를 두어 자동 호출을 막는 편이 안전합니다.
명령어 원본 선언
/skills공식 설명 요약
/skills는 현재 세션에서 쓸 수 있는 skill 목록을 보여주는 내장(built-in) 명령입니다.
공식 문서 설명을 그대로 옮기면 이렇습니다.
List available skills. Press
tto sort by token count. PressSpaceto hide a skill from Claude or the/menu, thenEnterto save. (사용 가능한 skill을 나열합니다.t를 누르면 토큰 수 기준으로 정렬하고,Space를 누르면 Claude나/메뉴에서 특정 skill을 숨긴 뒤Enter로 저장합니다.)
최신 Claude Code에서는 커스텀 명령(.claude/commands/)과 skill(.claude/skills/)이 동일한 slash command 경험으로 통합되었습니다.
같은 이름이 skill과 명령으로 같이 있으면 skill이 우선하니, 반복 업무 표준화 상태를 점검할 때는 /skills부터 확인하세요.
참고로 /skills 자체는 bundled skill이나 workflow가 아니라, CLI에 내장된 일반 명령입니다.
(/batch, /code-review, /run, /verify 등은 공식 표에서 Skill 배지가 붙은 bundled skill이지만 /skills에는 붙지 않습니다.)
최소 지원 버전
- 현재 공식
Commands문서에 포함되어 있으며, 공식 표에 별도의 최소 버전 표기(min-version)는 없습니다. - 함께 자주 쓰는
/reload-skills는 공식 문서 기준 v2.1.152부터 제공됩니다. 세션 도중 디스크에서 추가/변경된 skill과 명령 디렉터리를 다시 스캔합니다.
사용법
/skills메뉴가 열리면 다음 키로 조작합니다.
t: 토큰 수(token count) 기준 정렬 — 컨텍스트 비용이 큰 skill을 빠르게 찾습니다.Space: 강조된 skill의 표시 상태를 순환 전환(숨김 등)합니다. Claude 자동 호출에서 숨기거나/메뉴에서 숨겨 가시성을 조정합니다.Enter: 변경 사항을 저장합니다. 저장 결과는 skill 본문이 아니라.claude/settings.local.json의skillOverrides설정에 남습니다.
좋은 사용 예
- 프로젝트 진입 직후 팀이 제공한 skill 목록과 호출 가능 여부 확인
- 커스텀 명령이
/메뉴에 노출되지 않을 때 이름·우선순위·소스(개인/프로젝트/플러그인) 점검 t로 토큰 비용이 큰 skill을 찾아 정리 대상 선정- SKILL.md를 직접 수정할 수 없는 공유 프로젝트·MCP 제공 skill을
Space+Enter로 숨김 처리
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/skills | skill 목록 확인·정렬·가시성 조정 | 커스텀 워크플로우 탐색·정리 |
/reload-skills | skill·명령 디렉터리 재스캔 (v2.1.152) | 디스크에서 추가/수정 직후 반영 |
/plugin | 플러그인 설치/활성화 관리 | skill을 배포 단위로 관리 |
/fewer-permission-prompts | 승인 allowlist 제안 (bundled skill) | 반복 권한 프롬프트 줄이기 |
활용 사례
- 신규 팀원 온보딩 시
/skills로 프로젝트 자동화 표준 확인 .claude/skills와 플러그인 skill의 namespace·우선순위 점검- 자주 쓰는 커스텀 명령을 skill로 승격할지 판단
- 컨텍스트 예산을 많이 쓰는 skill을
t정렬로 식별한 뒤skillOverrides에서name-only로 낮추기
주의사항
- 동일 이름이 여러 위치에 있으면 enterprise → personal → project 순으로 재정의됩니다. 플러그인 skill은
plugin-name:skill-namenamespace를 쓰므로 다른 레벨과 충돌하지 않습니다. Space로 숨겨도 skill 파일 자체는 그대로이며, 변경은.claude/settings.local.json의skillOverrides에만 기록됩니다.- 부작용이 큰 skill은 SKILL.md에
disable-model-invocation: true를 설정해 Claude 자동 호출을 막고 사용자 직접 호출만 허용하는 편이 안전합니다./메뉴에서만 숨기려면user-invocable: false를 사용합니다(이 경우 Skill 툴 접근은 막지 못함). - skill 본문은 호출 후 세션 컨텍스트에 남으므로, 긴 레퍼런스는 별도 파일로 분리하세요.
출처
- Commands: https://code.claude.com/docs/en/commands
- Skills: https://code.claude.com/docs/en/skills
- Override skill visibility from settings: https://code.claude.com/docs/en/skills#override-skill-visibility-from-settings