Claude Code의 `★` 표시 명령어는 내부적으로 여러 단계를 자율 실행하는 '에이전트' 기능

Claude Code의 명령어 목록을 살펴보면, 일부 명령어에만 ★ 표시가 되어 있습니다. 이것이 바로 '스킬(Skill, Bundled Skill)'이며, 일반 명령어와는 구현 수준에서 근본적으로 다른 메커니즘임을 알게 되었습니다. 18종의 스킬 중 특히 구조가 흥미로웠던 것들을 정리합니다.

일반 명령어: /clear・/resume・/model
→ Claude Code 본체에 고정 구현되어 있으며, 정해진 동작만 수행함
스킬(★): /code-review・/batch・/init
...

/clear는 '대화 내용을 지우기'라는 하나의 작업을 즉시 실행하는 반면, /code-review는 'diff 분석 → 문제점 특정 → 카테고리별 리포트 → 필요 시 수정 제안'이라는 여러 단계를 자동으로 수행합니다. /skills 명령어로는 현재 로드된 스킬 목록을 확인할 수 있습니다.

실행 흐름:
1. 과거 트랜스크립트를 분석
2. 자주 사용되는 읽기 전용의 Bash/MCP 명령어를 특정
...

권한 확인 다이얼로그를 수동으로 하나씩 '허용'하는 것이 아니라, 지금까지의 이용 패턴을 바탕으로 '자주 사용되는 읽기 전용 명령어'를 자동으로 감지하여 허용 목록에 추가합니다. 작업 중에 권한 확인 창이 자주 뜰 때 실행하도록 설계된 것으로 보입니다.

/run: /run-skill-generator가 생성한 run 스킬을 호출하여 앱을 시작할 뿐임
/verify: 시작 + 변경 사항이 의도대로 작동하는지까지 확인함

비슷한 명령어이지만, /run은 앱의 실행 여부 확인, /verify는 코드 변경의 의도 확인이라는 별도의 목적을 가집니다. /run-skill-generator로 프로젝트 고유의 run-dev・run-test・run-build 스킬을 자동 생성해 두면, /run이 이를 호출할 수 있게 됩니다.

실행 흐름:
1. 코드베이스의 구조・기술 스택・관습을 자동 분석
2. 프로젝트 고유 정보를 CLAUDE.md에 기재
...

새로운 프로젝트를 설정할 때, /init으로 기본이 되는 CLAUDE.md를 자동으로 생성하고, /run-skill-generator로 run 스킬을 정비하며, /update-config와 /fewer-permission-prompts로 권한 관련 설정을 정리하는 일련의 초기화 흐름이 오직 스킬만으로 완결됩니다.

참조 가능한 정보:
모델 ID 목록과 가격, API 파라미터, 스트리밍・툴 사용・MCP,
에이전트・캐시・토큰 카운트, 모델 마이그레이션 가이드

Claude API를 이용한 앱 개발을 할 때, 명시적으로 호출하지 않아도 자동으로 트리거되는 경우가 있는 스킬입니다. 문서 사이트를 열지 않고 그 자리에서 API 레퍼런스를 확인할 수 있다는 점에서 일반 명령어와의 경험 차이가 확연했습니다.

스킬이 .claude/agents/*.md에 정의된 '여러 단계를 자율 실행하는 에이전트'라는 구현 수준의 이해가, 18종의 스킬을 활용하는 데 있어 기반이 되었습니다. /fewer-permission-prompts처럼 트랜스크립트 분석을 통해 자동 설정을 생성하는 스킬은 일반 명령어의 연장선상에 있는 동작이 아닙니다.