# create-agent

Scaffolds autonomous subagents for Claude Code with valid YAML frontmatter, isolated contexts, and triggering examples.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 installs · ★ 1787
- Author: NeoLabHQ
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NeoLabHQ/context-engineering-kit/tree/HEAD/skills/create-agent/SKILL.md
- Updated: 2026-08-26
- HTML: https://affpapa.org/en/nevibecode/skills/create-agent

## What it does

This skill generates configuration files for autonomous Claude Code subagents stored in `agents/*.md`. Unlike slash commands defined in `commands/*.md`, agents run as separate subprocesses spawned via the Task tool. The parent conversation invokes them automatically when incoming tasks match the trigger rules outlined in the description.

It enforces Anthropic frontmatter conventions. Agent identifiers require 3 to 50 characters using only lowercase letters, digits, and hyphens. The description must begin with "Use this agent when..." and provide `<example>` blocks with scenario context and expected replies. Skipping concrete examples causes erratic auto-triggering during active coding sessions.

Frontmatter fields also control UI badge colors, model inheritance (`inherit`, `sonnet`, `opus`, or `haiku`), and tool access. Restricting privileges to read-only utilities such as `Read` or `Grep` protects your codebase from unintended modifications during background reasoning.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add NeoLabHQ/context-engineering-kit --skill create-agent -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/create-agent/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/create-agent/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add NeoLabHQ/context-engineering-kit --skill create-agent -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/create-agent/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add NeoLabHQ/context-engineering-kit --skill create-agent -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/create-agent/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NeoLabHQ/context-engineering-kit create-agent
```

2. **Manually: put the files in place**
- File: `.github/skills/create-agent/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add NeoLabHQ/context-engineering-kit --skill create-agent -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/NeoLabHQ/context-engineering-kit --path skills/create-agent
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/create-agent/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add NeoLabHQ/context-engineering-kit --skill create-agent -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/NeoLabHQ/context-engineering-kit/tree/HEAD/skills/create-agent/SKILL.md

## When to use it
- Scaffold subagent configuration files for Claude Code
- Define automatic trigger conditions using structured dialogue examples
- Restrict agent permissions to read-only tools for safer execution
- Assign dedicated UI colors and models to background subagents

## Example prompts
- Create a code-reviewer subagent that triggers when I ask to inspect git diffs
- Generate a security-analyzer agent restricted to Read, Grep, and Glob tools
- Draft an agent file for automated test generation using the sonnet model

## Similar
- [create-handoff](https://affpapa.org/en/nevibecode/skills/create-handoff.md) — skill · 508 installs
- [create-agent-skills](https://affpapa.org/en/nevibecode/skills/create-agent-skills.md) — skill · 503 installs
- [argent-create-e2e](https://affpapa.org/en/nevibecode/skills/argent-create-e2e.md) — skill · 979 installs
- [diff-intake](https://affpapa.org/en/nevibecode/skills/diff-intake.md) — skill · 42800 installs
- [remotion-create](https://affpapa.org/en/nevibecode/skills/remotion-dev-remotion-create.md) — skill · 214000 installs
- [home-assistant-best-practices](https://affpapa.org/en/nevibecode/skills/home-assistant-best-practices.md) — skill · 8600 installs

From the same set: [neolabhq/context-engineering-kit](https://affpapa.org/en/nevibecode/by/neolabhq/context-engineering-kit.md) — 64 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md