claude-code-skills MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

7 independently-installable plugins, shared marketplace
135+ reusable skills organized as orchestrators/coordinators/workers
3 bundled MCPs: hex-line, hex-graph, hex-ssh
Multi-model review: Codex + Gemini parallel with Claude fallback

라이브 데모

실제 사용 모습

claude-code.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-code": {
      "command": "npx",
      "args": [
        "-y",
        "claude-code-skills"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-code": {
      "command": "npx",
      "args": [
        "-y",
        "claude-code-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-code": {
      "command": "npx",
      "args": [
        "-y",
        "claude-code-skills"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-code": {
      "command": "npx",
      "args": [
        "-y",
        "claude-code-skills"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-code",
      "command": "npx",
      "args": [
        "-y",
        "claude-code-skills"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-code": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "claude-code-skills"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add claude-code -- npx -y claude-code-skills

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: claude-code-skills

Bootstrap a new project with Clean Architecture via claude-code-skills

👤 Solo devs, startup founders ⏱ ~30 min intermediate

언제 쓸까: You want a structured starting point instead of a blank directory.

사전 조건

Claude Code installed — claude.ai/code

흐름

Install the marketplace

Add the claude-code-skills marketplace and install 'Project Bootstrap'.✓ 복사됨

→ Plugin installed and commands available
Scaffold

Use the bootstrap skill to scaffold a Python FastAPI project with Clean Architecture: domain / application / infrastructure / interfaces layers.✓ 복사됨

→ Directory tree with the standard layering + example module
Set up dev env

Use Setup Environment to add pre-commit, linters, test runner.✓ 복사됨

→ Working make test out of the box

결과: A day-1 project with the structure you'd refactor toward eventually.

Get multi-model code review with claude-code-skills

👤 Teams that want cross-checked AI reviews ⏱ ~20 min advanced

언제 쓸까: Before merging significant PRs, you want more than one model's opinion.

사전 조건

Codex and Gemini API keys configured — Plugin docs show env var names

흐름

Run the review skill

Use the Agile Workflow plugin's review skill on PR #123. Run Codex and Gemini in parallel; fall back to Claude if either times out.✓ 복사됨

→ Three-column review: security, architecture, style
Aggregate disagreements

Where do the models disagree? Highlight those for human review.✓ 복사됨

→ Disagreement list — the most valuable section

결과: A review that surfaces issues a single model would miss.

함께 쓰기: github

Auto-generate and maintain docs with the documentation pipeline

👤 Teams behind on docs ⏱ ~40 min intermediate

언제 쓸까: Your README and architecture docs haven't been updated in months.

흐름

Run framework detection + initial gen

Run the Documentation Pipeline on this repo. Detect framework, generate README, architecture.md, and contributing.md.✓ 복사됨

→ Draft docs reflecting actual code
Set up refresh on CI

Add a CI job that regenerates doc sections marked  on every merge.✓ 복사됨

→ Docs stay fresh

결과: Living docs backed by the same codebase source of truth.

Run a full codebase audit (security, quality, architecture)

👤 Tech leads inheriting a codebase ⏱ ~60 min intermediate

언제 쓸까: First week on a new repo — you need a map and a risk list.

흐름

Audit

Run the Codebase Audit Suite. Return security, quality, architecture, test-coverage findings ranked by impact.✓ 복사됨

→ Prioritized findings with file citations
Triage into backlog

Convert top-10 findings into GitHub issues with labels.✓ 복사됨

→ Backlog populated

결과: A clear picture of what to fix first.

함께 쓰기: github

조합

다른 MCP와 조합해 10배 효율

claude-code + github

Audit findings → issues → PRs via the same suite

Run the audit, create issues for the top 10 findings, then draft PRs for the first 3.✓ 복사됨

claude-code + hyper

Replace miscellaneous MCPs with a single hyper-mcp host

Keep hex-line/graph/ssh; retire unrelated npm MCPs in favor of signed plugins in hyper-mcp.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
hex-line (MCP)	file edit ops with hash verification	When correctness of edits matters — avoids 'phantom edit' bugs	0
hex-graph (MCP)	codebase queries	Navigate symbol references, callers, imports	0 after index
hex-ssh (MCP)	host, command	Run commands on dev/prod boxes via SSH with audit	0

비용 및 제한

운영 비용

API 쿼터: Uses your LLM quotas plus whatever the MCPs reach
호출당 토큰: Audit skills can use 20k+ tokens — worth it once per project
금액: Free, MIT
팁: Install only the plugins you need — all 7 active at once is overwhelming

보안

권한, 시크릿, 파급범위

자격 증명 저장: SSH keys for hex-ssh via standard ~/.ssh; no secrets stored by the suite

데이터 외부 송신: Depends on enabled plugins

절대 부여 금지: broad SSH to prod without audit

문제 해결

자주 발생하는 오류와 해결

Plugin commands missing after install

Restart Claude Code; plugin registry is loaded at session start

Multi-model review times out on one model

Plugin falls back to Claude — check logs for which model failed and why

hex-ssh fails with auth error

SSH config must work without interactive prompts; use keys not passwords

확인: ssh -o BatchMode=yes user@host true

대안

claude-code-skills 다른 것과 비교

대안	언제 쓰나	단점/장점
Individual MCPs composed yourself	You prefer hand-picked tools over a suite	More setup; no shared orchestration model
Cursor Rules + built-ins	You use Cursor, not Claude Code	Different ecosystem

claude-code-skills

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: claude-code-skills

Bootstrap a new project with Clean Architecture via claude-code-skills

사전 조건

흐름

Get multi-model code review with claude-code-skills

사전 조건

흐름

Auto-generate and maintain docs with the documentation pipeline

흐름

Run a full codebase audit (security, quality, architecture)

흐름

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

claude-code-skills 다른 것과 비교

더 보기

리소스