wshobson agents (Claude Skill) — 사용 사례, 설치 & 라이브 데모

Name: wshobson agents (Claude Skill)
Author: wshobson

왜 쓰나요

핵심 기능

풀 스택을 커버하는 83개의 전문가
멀티 에이전트 워크플로우를 위한 오케스트레이터 에이전트
각 에이전트는 프론트매터에 명확한 위임 규칙 보유
실제 고객 프로젝트에서 테스트됨
MIT 라이선스, 포크 및 커스터마이즈 용이

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

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

{
  "mcpServers": {
    "wshobson-agents-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wshobson/agents",
        "~/.claude/agents"
      ],
      "_inferred": true
    }
  }
}

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

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

{
  "mcpServers": {
    "wshobson-agents-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wshobson/agents",
        "~/.claude/agents"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "wshobson-agents-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wshobson/agents",
        "~/.claude/agents"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wshobson-agents-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wshobson/agents",
        "~/.claude/agents"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "wshobson-agents-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wshobson/agents",
        "~/.claude/agents"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "wshobson-agents-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/wshobson/agents",
          "~/.claude/agents"
        ]
      }
    }
  }
}

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

claude mcp add wshobson-agents-skill -- git clone https://github.com/wshobson/agents ~/.claude/agents

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

사용 사례

실전 활용법: wshobson agents

자동 라우팅된 전문가로 기능을 처음부터 끝까지 구축

👤 풀스택 기능을 구축하는 솔로 개발자 ⏱ ~60 min intermediate

언제 쓸까: 컨텍스트 전환 프롬프트 없이 백엔드 + 프론트엔드 + 테스트 + 리뷰를 원할 때.

사전 조건

Claude Code 설치 — npm install -g @anthropic-ai/claude-code
에이전트 클론 — git clone https://github.com/wshobson/agents ~/.claude/agents

흐름

오케스트레이터로 시작

Use orchestrator-agent. Build a CRUD feature for 'invoices' — backend (FastAPI), frontend (Next.js), tests, review.✓ 복사됨

→ 전문 에이전트로 라우팅된 하위 작업이 있는 계획
각 핸드오프 관찰

Show me each agent's contribution as it goes. Pause for my approval after backend before frontend starts.✓ 복사됨

→ 체크포인트가 있는 에이전트별 diff
최종 보안 검토

Run security-auditor on the diff. Anything risky?✓ 복사됨

→ 발견 사항이 있는 보안 보고서

결과: 레이어별 적절한 전문가와 함께 출시된 풀스택 기능.

함정

오케스트레이터가 사소한 작업도 과도하게 위임 — 간단한 변경에는 --no-orchestrator로 재정의

함께 쓰기: desktop-commander-mcp

전용 code-reviewer 에이전트로 코드 리뷰 실행

👤 PR에서 '괜찮아 보임' 이상을 원하는 모든 사람 ⏱ ~20 min beginner

언제 쓸까: 단순히 승인만 해주지 않는 철저한 리뷰를 원할 때.

흐름

diff 준비

Run code-reviewer on the current branch's diff vs main. Group findings by severity.✓ 복사됨

→ 심각도 1/2/3 그룹별 발견 사항
수정 적용

Apply the sev-1 findings now. Park sev-2/3 for later.✓ 복사됨

→ diff 업데이트, 제안 추적됨

결과: 'lgtm'보다 신호 품질이 높은 리뷰.

함께 쓰기: wshobson-commands-skill

오케스트레이션 없이 특정 전문가를 직접 호출

👤 어떤 전문 지식이 필요한지 정확히 아는 개발자 ⏱ ~30 min intermediate

언제 쓸까: 목표가 명확한 작업; 계획-라우팅이 필요 없을 때.

흐름

에이전트 선택

Use database-architect agent. Design a schema for multi-tenant orders with audit trail.✓ 복사됨

→ 근거가 있는 스키마
같은 에이전트로 반복

Stay in database-architect. Now add a hot/cold partition strategy for 100M rows.✓ 복사됨

→ 정제된 설계

결과: 오케스트레이터 오버헤드 없는 도메인 특화 출력.

조합

다른 MCP와 조합해 10배 효율

wshobson-agents-skill + wshobson-commands-skill

슬래시 명령이 특정 에이전트를 빠르게 트리거

/review triggers code-reviewer; /audit triggers security-auditor.✓ 복사됨

wshobson-agents-skill + desktop-commander-mcp

에이전트가 계획하고, desktop-commander가 실행

Backend-architect plans; desktop-commander writes the files.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
orchestrator-agent	high-level goal	멀티 도메인 기능	Coordinator overhead — multi-step
backend-architect	service spec	백엔드 결정	0
frontend-developer	ui spec	UI 작업	0
code-reviewer	diff	머지 전 게이트	0
security-auditor	diff or code	위험한 변경사항	0

비용 및 제한

운영 비용

API 쿼터: 해당 없음 — 로컬 스킬
호출당 토큰: 오케스트레이터 모드에서 높음 (멀티 에이전트 조율)
금액: 무료 (MIT)
팁: 단일 도메인 작업에는 오케스트레이터를 건너뛰고 전문가를 직접 호출

보안

권한, 시크릿, 파급범위

최소 스코프: filesystem-read

자격 증명 저장: 없음 — 순수 프롬프트

데이터 외부 송신: 없음 (스킬은 로컬 파일)

에이전트는 Claude Code에 부여한 모든 도구를 실행할 수 있음; 스킬이 아닌 Claude의 권한을 엄격히 제한

문제 해결

자주 발생하는 오류와 해결

에이전트를 찾을 수 없음

파일이 .md 확장자와 올바른 프론트매터를 가지고 ~/.claude/agents/에 있는지 확인

확인: claude --list-agents

오케스트레이터가 무한 루프

프롬프트에 명시적 종료 기준 추가; 오케스트레이터는 '언제 멈출지'를 따름

잘못된 전문가로 라우팅

프론트매터 설명 필드 확인 — 오케스트레이터는 설명 일치로 라우팅

대안

wshobson agents 다른 것과 비교

대안	언제 쓰나	단점/장점
wshobson/skills (sibling)	서브에이전트가 아닌 스킬(Anthropic 스킬 형식)을 원할 때	다른 형식, 같은 개발자
obra/superpowers	다른 의견을 가진 큐레이션된 멀티 스킬 번들	더 작고 더 의견이 강함

wshobson agents