Skip to content

This-HW/hiway-kit / plugins/common/skills/agent-creator

agent-creator

Unverified

Create a Claude Code sub-agent definition for this project or user. Use when the user asks to create a new custom agent or a specialized sub-agent for a recurring task.

FileKindSize
SKILL.mdskill md3.9 KB
agents/openai.yamlconfig315 B
---
name: agent-creator
description: Create a Claude Code sub-agent definition for this project or user. Use when the user asks to create a new custom agent or a specialized sub-agent for a recurring task.
---

# Agent Creator

이 프로젝트(또는 사용자)용 Claude Code 서브에이전트 정의 파일을 만든다.

> **서브에이전트가 없는 하네스**(Codex 등)에서는 에이전트 파일이 인식되지 않는다 — 그 경우
> 같은 절차를 스킬이나 진입점 문서(`AGENTS.md`)의 절로 만드는 편이 맞는지 사용자에게 먼저 묻는다.

## 생성 워크플로우

1. **요구사항 수집** — 목적, 언제 위임할지(구체 조건), 필요한 도구, 파일 수정 여부.
2. **위치 결정** — 프로젝트 공유면 `.claude/agents/<name>.md`, 개인용이면
   `~/.claude/agents/<name>.md`. 설치된 플러그인 캐시 안에는 쓰지 않는다(업데이트 때 사라진다).
   같은 이름이 이미 있으면 덮어쓰지 말고 사용자에게 알린다.
3. **설정 결정** — 도구는 필요한 최소만 허용한다. 읽기 전용 역할에는 `Edit`·`Write` 를 주지
   않는다. 모델·effort 는 생략하면 호스트 기본값을 따른다 — 지정은 이유가 있을 때만.
4. **파일 생성 후 검증** — frontmatter 가 파싱되는지(`name`·`description` 필수, `name` 은
   파일명과 같은 kebab-case), 도구 이름이 호스트에 실제로 있는지 확인한다. 없는 MCP 도구를
   allowlist 에 넣으면 그 서버가 없는 환경에서 에이전트가 환각한다.

## description 쓰는 법

위임은 description 으로 결정된다. **무엇이 주어졌을 때 쓰는지**를 구체적으로 쓴다.
"~해줘"·"확인"·"오류" 같은 일상 표현 단독 트리거는 대화형 요청까지 끌어가 느린 경로로
빼돌린다 — 다른 에이전트와 트리거가 겹치지 않는지도 본다.

- **끝에 부정 조건 한 문장** — `Do not use for …`. 겹치기 쉬운 이웃 요청을 막는다. description 은 매 세션
  노출되는 바이트이므로 **한 문장까지만** 쓴다.

## 본문에 넣을 것

- **쓰지 말 때 → 대신 표.** 부정 조건 문장은 *안 쓴다*는 것만 말한다. 어디로 가야 하는지는 본문 표가 말한다.

  | 이럴 때 | 대신 |
  | --- | --- |
  | [겹치기 쉬운 요청] | [그 일을 맡는 다른 에이전트·스킬, 또는 직접 처리] |

- **출력 필드마다 Bad/Good 예시 한 쌍** — 근거·사유·판정처럼 읽는 사람이 그대로 행동하는 자유 서술 필드에.
  Bad 는 그럴듯하지만 막연한 버전, Good 은 확인 가능한 버전이다.

## 출력 형식

```markdown
---
name: [소문자-하이픈]
description: [역할]. Use when [구체 조건 — 무엇이 주어졌을 때]. Do not use for [겹치기 쉬운 이웃 요청].
tools:
  - [도구 목록]
---

[시스템 프롬프트 — 역할, 쓰지 말 때 → 대신 표, 절차, 출력 형식(필드별 Bad/Good), 끝났음을 알리는 마지막 줄]
```

## 예제

```markdown
---
name: migration-checker
description: Database migration reviewer. Use when a new migration file under db/migrations/ is added or changed and needs a safety review before merge. Do not use for writing or running migrations.
tools:
  - Read
  - Grep
  - Glob
---

You review database migrations for safety.

| When | Instead |
| --- | --- |
| A migration needs to be written | Write it in the main session |
| A migration needs to be applied | Run the project's migration command yourself |

1. Read the changed migration files
2. Flag locking operations, missing down-migrations, and destructive column changes
3. Report findings as a list — each with file:line and why it is unsafe — then end with `## 완료: <N> findings`

   Bad:  `0042_users.py — risky change`
   Good: `0042_users.py:18 — ALTER COLUMN email SET NOT NULL rewrites the table under an exclusive lock`
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall