AgentSkillsCN

create-agent

在创建并运行 Claude Code 自定义代理时所使用的技能。 当用户发出“创建代理”“生成 Claude 代理”或“—agents 设置”的请求时，该技能将被激活。

SKILL.md
--- frontmatter
name: create-agent
description: |
  Claude Code 커스텀 에이전트를 만들고 실행할 때 사용하는 스킬.
  사용자가 "에이전트 만들어", "Claude agent 생성", "--agents 설정"을 요청하면 활성화됩니다.
argument-hint: "[agent-name] [agent-description]"
disable-model-invocation: false
user-invocable: true
allowed-tools: Read, Write, Edit, Bash

Claude Code 에이전트 생성/실행 가이드

요청: $ARGUMENTS

이 스킬은 Claude CLI에서 확인한 실제 방식만 사용한다.

  • •에이전트 정의 주입: --agents <json>
  • •실행 에이전트 선택: --agent <name>

1) 생성 규칙

  1. •에이전트 이름은 lowercase-hyphen 형식으로 만든다.
  2. •에이전트 정의는 JSON 객체로 작성한다.
  3. •각 엔트리는 아래 키를 사용한다.
    • •description: 언제 쓰는지 한 줄 설명
    • •prompt: 에이전트 시스템 지시문

예시:

json
{
  "issue-infer-extract-symptom": {
    "description": "증상 텍스트를 추출하는 에이전트",
    "prompt": "너는 증상 추출 전문가다. ..."
  }
}

2) 저장 위치

프로젝트 기준 아래 경로를 기본으로 사용한다.

  • •.claude/agents/agents.json
  • •필요 시 에이전트별 원문 프롬프트 문서: .claude/agents/<agent-name>.md

3) 실행 방법

단발 실행

bash
claude -p \
  --agents "$(cat .claude/agents/agents.json)" \
  --agent <agent-name> \
  "<실행 프롬프트>"

대화형 시작

bash
claude --agents "$(cat .claude/agents/agents.json)"

필요하면 시작 시 바로 선택:

bash
claude --agents "$(cat .claude/agents/agents.json)" --agent <agent-name>

4) 변환(마이그레이션) 작업 지침

OpenCode/기타 형식에서 변환 요청을 받으면 아래 순서로 처리한다.

  1. •원본 frontmatter의 name, description을 우선 보존한다.
  2. •본문 지시문은 prompt로 이동한다.
  3. •OpenCode 전용 필드(mode, tools 등)는 Claude JSON에 직접 넣지 않는다.
  4. •결과를 .claude/agents/agents.json에 합친다.
  5. •최소 1개 에이전트는 claude -p --agents ... --agent ...로 실행 검증한다.

5) 완료 보고 형식

작업 완료 시 아래를 반드시 보고한다.

  • •생성/수정 파일 목록
  • •사용한 실행 명령
  • •검증 결과(성공/실패 + 핵심 로그)
  • •다음 액션(필요 시)