Claude Code에는 후크 (Hook), 스킬 (Skill), MCP 서버, 서브 에이전트 (Sub-agent), 슬래시 커맨드 (Slash command) 및 확장 메커니즘이 갖춰져 있다. 하지만 막상 자신의 리포지토리 (Repository)에 도입하려고 하면 손이 멈춘다. 어떤 것이 자신의 프로젝트에 효과적일지 판단하기 어렵고, MCP 서버는 선택지가 너무 많다. 결국 "편리해 보여서" 설치해 두고 사용하지 않는 일을 나도 몇 번이나 반복했다.

이 "무엇을 설치해야 할지 모르겠다"는 문제를 채워주는 것이 Anthropic 공식 플러그인 claude-code-setup에 포함된 스킬 claude-automation-recommender이다.

코드베이스 (Codebase)를 분석하여 해당 프로젝트에 적합한 자동화를 추천해 준다.

하는 일은 프로젝트를 조사하여 자동화를 제안하는 것뿐이다. 공식 설명에 따르면, 프로젝트 구조, 의존 관계, 패턴을 확인한 후 5가지 카테고리에 걸쳐 통합을 제안한다고 한다.

대상은 다음 5가지다.

• MCP 서버: 외부 서비스 연동 (문서 참조, DB 조작, 브라우저 조작 등)
• 스킬: 특정 태스크를 묶은 지식·절차
• 후크: 정해진 타이밍에 실행되는 처리 (자동 포맷팅, 기밀 파일 차단 등)
• 서브 에이전트: 보안이나 퍼포먼스 등 전문 영역의 리뷰 담당
• 슬래시 커맨드: /test나 /pr-review와 같은 정형 워크플로우 (Workflow)

한 가지 중요한 점은 이 스킬이 읽기 전용 (Read-only)이라는 점이다. 분석하여 제안은 내놓지만, 파일을 마음대로 만들거나 수정하지는 않는다. 도입 여부에 대한 판단과 실행은 사용자 측에 남아 있다. 이 점이 안심하고 호출할 수 있는 이유가 된다.

내부적으로는 package.json, pyproject.toml, Cargo.toml, go.mod와 같은 의존성 파일이나 src/, app/, api/와 같은 디렉토리 구성을 보고 사용 중인 프레임워크 (Framework)나 라이브러리 (Library)를 검출하는 것으로 보인다. React 프론트엔드라면 브라우저 조작 계열의 MCP 서버, 인증 관련 코드가 있다면 보안 리뷰용 서브 에이전트와 같은 식으로 제안이 달라진다.

고정 리스트에서 선택하는 것뿐만 아니라, 해당 코드베이스 고유의 툴에 특화된 제안을 웹 검색으로 찾는다는 지시도 스킬에 포함되어 있다고 한다. 이 부분은 실제로 구동했을 때 결과의 편차가 있을 것 같으며, 최신 툴을 잡아낼 수 있을지는 프로젝트에 따라 다를 것이라 생각한다.

Claude Code 상에서 이를 실행한다.

/plugin install claude-code-setup@claude-plugins-official

claude-plugins-official은 Anthropic이 관리하는 공식 마켓플레이스 (Marketplace)로, Claude Code를 실행한 시점에서 바로 사용할 수 있다. 마켓플레이스를 별도로 등록할 필요는 없다.

설치 시 스코프 (Scope)를 묻는다.

• User: 자신 전용, 모든 프로젝트에서 사용 가능
• Project: 리포지토리 설정에 포함하여 공동 작업자 전원에게 적용
• Local: 이 리포지토리 한정, 자신만 사용

어떤 프로젝트에서도 사용하는 범용 툴이므로, 나는 User를 선택했다. 프로젝트마다 다시 설치하는 번거로움이 없어진다.

명시적인 커맨드라기보다 자연어 (Natural language) 호출로 동작하도록 설계되어 있다. 다음과 같은 프롬프트 (Prompt)에 반응한다.

recommend automations for this project

help me set up Claude Code

what hooks should I use?

일본어로도 "이 리포지토리에 맞는 hook이나 subagent를 제안해줘"라고 하면 정상적으로 동작했다.

실행하면 먼저 프로젝트 개요 (검출된 언어·프레임워크·주요 라이브러리)가 나오고, 이어서 각 카테고리별로 1~2건씩 가치가 높다고 판단된 추천 사항이 나열된다. Next.js + TypeScript + Prisma + Postgres 구성이라면 다음과 같은 제안이 반환되는 사례가 공개되어 있다.

• MCP 서버: context7 (새로운 라이브러리의 API 문서를 참조하여 오래된 지식으로 인한 구현 실수를 방지)
• 스킬: 리포지토리 내의 템플릿이나 커밋 히스토리의 패턴으로부터 독자적인 스킬을 만드는 제안
• 후크: 자동 포맷팅이나 기밀 파일의 오커밋 (誤commit) 방지

각 제안에 「왜 유효한가」에 대한 이유가 붙기 때문에, 근거를 보고 판단할 수 있다. 다만 이유의 상세도는 제안에 따라 제각각이라, context7처럼 딱 와닿는 것도 있는 반면, 「독자적인 스킬을 만드는 제안」 정도의 추상적인 수준에 머무는 것도 있다. 더 깊이 파고들고 싶은 카테고리는 「MCP 서버의 선택지를 더 보여줘」라고 추가로 물어볼 수 있다. 구현까지 도움을 받고 싶다면 그대로 계속 요청하면 된다.

상주 플러그인이 컨텍스트 (Context)를 압박하지 않을까 하는 점은 도입 전에 신경 쓰이는 부분이다. 이 점은 공개되어 있으며,

• 매 턴: 약 130 토큰 (Token)
• 스킬 발동 시: 약 3.5k 토큰 (Token)

평소 대화에서는 거의 무시할 수 있는 대기 비용이며, 호출했을 때만 집중적으로 사용한다. 항상 넣어두어도 실용적인 부담은 작다.

일반론적으로, 후크 (Hook)는 명령어를 자동 실행하고, MCP 서버는 외부와 통신한다. 제공처를 확인한 뒤에 설치하는 것이 좋다. 이번 claude-code-setup은 내용이 스킬 1개뿐이며, 후크도 MCP 서버도 동봉되어 있지 않다. 읽기 전용이기도 하므로, 시도하는 장벽은 낮은 편이다.

claude-automation-recommender는 확장 기능 중에서 「현재 프로젝트에 필요한 것」을 추려내기 전의 상담역이다. 화려한 기능은 아니며, 제안을 무조건 믿을 수 있을 정도로 정밀도가 높은 것도 아니다. 다만, 새로운 리포지토리 (Repository)에 착수했을 때나, 기존 프로젝트의 개발 환경을 재검토하고 싶을 때 한 번 호출하면, 놓치고 있었던 메커니즘을 깨달을 수 있는 경우가 있다.

도입과 운용 모두 가볍기 때문에, 우선 손에 있는 프로젝트에서 「recommend automations for this project」라고 물어보는 정도의 가벼운 마음으로 시도해 보는 것이 딱 적당하다.