클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

에이전트 디자이너 (멀티 에이전트 아키텍처 설계)

요구사항 JSON으로 멀티 에이전트 아키텍처를 설계하고, 툴 스키마를 생성·검증하며, 실행 로그의 비용·지연·병목을 평가해 주는 스킬입니다.

개발·코딩고급★ 24,151⑂ 3,405AI 점수 8/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

agent-designer는 멀티 에이전트 시스템을 "감"이 아니라 결정적(deterministic) 스크립트로 설계하게 해주는 스킬입니다.

  • 아키텍처 설계: agent_planner.py가 요구사항(목표, 태스크, 응답시간·예산·동시성 제약, 팀 규모)을 점수화해 Single / Supervisor / Pipeline / Hierarchical / Swarm 중 적합한 패턴을 고르고, 에이전트 역할·통신 링크·Mermaid 다이어그램·도입 로드맵을 출력합니다.
  • 툴 스키마 생성: tool_schema_generator.py가 평문 툴 설명을 Anthropic·OpenAI 형식 스키마로 변환하고 --validate로 유효성을 검사합니다. 모든 툴이 ✓ Valid가 될 때까지 진행 금지라는 게이트가 명시돼 있습니다.
  • 실행 평가: agent_evaluator.py가 성공률, 지연 분포, 비용 분해, SLA 준수, 병목·에러 분석과 개선 권고를 JSON으로 내놓습니다.
  • 검증 루프: 유효하지 않은 스키마 0건 + 크리티컬 이슈 0건이 될 때까지 재실행하는 절차까지 규정돼 있습니다.

이런 분께 추천

  • 여러 에이전트를 조합한 자동화 시스템을 처음 설계하거나 구조를 재정비하려는 AI 엔지니어
  • 툴 콜(Function calling) 스키마를 여러 프로바이더용으로 일관되게 관리해야 하는 팀
  • 이미 돌아가는 에이전트 파이프라인의 비용·지연 병목을 데이터로 증명해야 하는 리드 개발자

활용 예시

  1. 리서치 자동화 설계: "논문 수집·요약·검증을 하는 에이전트 구조를 설계해줘" → 요구사항 JSON 작성 후 플래너 실행, Supervisor 패턴과 3개 전문 에이전트 + Mermaid 다이어그램 확보.
  2. 툴 스키마 일괄 생성: 사내 API 10개의 설명문을 넣어 tools_anthropic.json / tools_openai.json을 한 번에 생성하고 검증 통과 여부 확인.
  3. 운영 로그 진단: 파일럿 실행 로그를 평가기에 넣어 "검색 에이전트가 전체 지연의 62%를 차지"라는 병목을 찾고, 권고안 상위 항목을 적용해 재측정.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 alirezarezvani/claude-skills 의 .gemini/skills/agent-designer 폴더를 내 ~/.claude/skills/agent-designer/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/alirezarezvani/claude-skills.git && mkdir -p ~/.claude/skills && cp -r claude-skills/.gemini/skills/agent-designer ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 Python 3가 설치돼 있는지 확인합니다: python3 --version
  2. 저장소를 내려받습니다: git clone https://github.com/alirezarezvani/claude-skills.git
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 스킬 폴더 전체를 복사합니다 (스크립트·assets·references가 함께 있어야 동작합니다): cp -r claude-skills/.gemini/skills/agent-designer ~/.claude/skills/
  5. Claude Code를 재시작한 뒤 "멀티 에이전트 아키텍처를 설계해줘"처럼 요청하면 스킬이 활성화됩니다.
  6. 처음에는 assets/sample_system_requirements.json을 복사해 값만 바꿔 쓰는 것을 권장합니다.
GitHub에서 원본 보기 ↗라이선스: MIT