# create-agent

create-agent generates configured subagent markdown files for Claude Code with frontmatter and system prompts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-skills/skills/create-agent/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/samarth-gupta-create-agent

## What it does

This skill builds specialized Claude Code agents formatted as markdown documents with YAML frontmatter. When invoked without arguments, it interviews the developer about the target role, trigger events, reasoning effort, and tool permissions. The output runs as a subprocess inside its own isolated context.

Frontmatter setup follows a least-privilege approach. Analysis agents receive read and search tools only, leaving shell execution or file writes disabled unless explicitly required. The skill can also configure cross-session memory with `project`, `user`, or `local` scopes.

Agent identifiers face strict validation rules: they must stay between 3 and 50 characters, banning underscores and generic labels like `assistant` or `helper`.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-skills@Claudest
```
This installs the whole claude-skills plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill create-agent -a claude-code
```

3. **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 gupsammy/Claudest --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 gupsammy/Claudest --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 gupsammy/Claudest plugins/claude-skills/skills/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 gupsammy/Claudest --skill create-agent -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-skills/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

### 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/gupsammy/Claudest/tree/HEAD/plugins/claude-skills/skills/create-agent/SKILL.md

## When to use it
- draft a system prompt for an autonomous subagent
- configure frontmatter tool permissions using least privilege
- set up cross-session agent memory scopes
- define background execution and isolation settings

## Example prompts
- create an agent for code review
- make a subagent api-docs-writer with read-only tools
- write an agent file with project memory enabled

## Similar
- [create-agent-skills](https://affpapa.org/en/nevibecode/skills/create-agent-skills.md) — skill · 508 installs
- [skillopt-sleep](https://affpapa.org/en/nevibecode/skills/skillopt-sleep.md) — skill · 12 installs
- [create-command](https://affpapa.org/en/nevibecode/skills/create-command.md) — skill · 1200 installs
- [create-assistant](https://affpapa.org/en/nevibecode/skills/create-assistant.md) — skill · 1100 installs
- [plur-create-engrams](https://affpapa.org/en/nevibecode/skills/plur-create-engrams.md) — skill · ★ 318 repo stars
- [create-handoff](https://affpapa.org/en/nevibecode/skills/create-handoff.md) — skill · 513 installs

## Other versions with the same name
- [create-agent · neolabhq](https://affpapa.org/en/nevibecode/skills/create-agent.md) — 1300 installs
- [create-agent · vicotrbb](https://affpapa.org/en/nevibecode/skills/vicotrbb-create-agent.md) — ★ 121 repo stars

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 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
