Our review

This skill guides the creation and execution of custom Claude Code agents using the --agents and --agent CLI flags.

Strengths

Clear structure with ready-to-use JSON examples
Supports migration from other formats like OpenCode
Detailed instructions for both one-shot and interactive execution
Systematic validation by test execution

Limitations

Requires knowledge of file paths and shell commands
Migration from other formats may be partial due to feature mismatches
No automatic dependency management between agents

When to use it

Use this skill when you need to create, configure, or run a custom Claude Code agent to automate repetitive tasks.

When not to use it

Avoid this skill if you need a generic assistant without Claude Code-specific CLI configuration.

Examples

Create a code review agent

Create a new agent named 'code-review' that checks pull requests for style issues and provides feedback.

Migrate OpenCode config

Convert my OpenCode agents.json to Claude Code agent format and save it to .claude/agents/agents.json.

Run existing agent interactively

Run the 'issue-infer' agent with a prompt to extract symptoms from a bug report.

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) 생성 규칙

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

예시:

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

2) 저장 위치

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

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

3) 실행 방법

단발 실행

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

대화형 시작

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

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

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

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

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

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

5) 완료 보고 형식

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

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

Create Claude Code Agents

Recommended for