create-agent

Creates specialist agent definitions from templates with per-harness JSON frontmatter for Claude, Codex, and Grok.

4|1|Updated Jul 31, 2025
One-click install
npx skills add https://github.com/alvis/.agents --skill create-agent-alvis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-agent
Source: https://github.com/alvis/.agents/tree/main/plugins/governance/skills/create-agent
Command: npx skills add https://github.com/alvis/.agents --skill create-agent-alvis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Defining a new specialist subagent requires coordinating a base prompt, shared metadata, and three harness-specific JSON files while avoiding duplicate roles, wrong intelligence levels, and inconsistent trigger surfaces. This Skill scaffolds the full five-file agent definition with confirmed settings before anything is written. ## Core Features & Use Cases - Five-file agent scaffolding: Generates base.md plus frontmatter/meta.json, claude.json, codex.json, and grok.json under the owning plugin's agents/<name>/ directory. - Archetype-based configuration: Classifies the role as producer, critic, or orchestrator and derives intelligence level, permissionMode, memory, and isolation settings, confirming deviations with the user via a structured prompt. - Duplicate and overlap rejection: Searches existing agent descriptions and callers to reject roles already covered, routing modifications to update-agent instead. - Deterministic verification: Validates JSON with Python and runs Essential's stitch helper for all three harnesses into temporary outputs, checking placeholders, routing rows, and trigger non-overlap. - Use Case: When you need a new frontend-implementer subagent, invoke this Skill with the role description; it classifies the role, proposes intelligence and permission settings, confirms them, writes the five canonical files, updates the plugin's routing table, and verifies the stitched output. ## Quick Start Ask the agent to create a new specialist agent for your role, for example: create a new agent called frontend-implementer owned by the coding plugin.

Frequently Asked Questions about create-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new subagent for Claude Code, Codex, and Grok?

Invoke the create-agent skill with a role description. It classifies the role into an archetype, proposes intelligence and permission settings, confirms them with you, then writes base.md plus meta.json, claude.json, codex.json, and grok.json under the owning plugin's agents directory.

What files does an agent definition contain?

An agent definition contains exactly five canonical source files: base.md holding the role's working voice, frontmatter/meta.json with name, description, and intelligence, plus claude.json, codex.json, and grok.json for harness-specific fields. The codex and grok files are required but normally empty objects.

When should I use create-agent versus update-agent?

Use create-agent only for genuinely new specialist roles that no existing agent covers. Use update-agent for modifying an existing agent definition. Create-agent actively rejects duplicate roles and routes you to update-agent instead of authoring a competing trigger surface.

How is the intelligence level chosen for a new agent?

The skill classifies the role as producer, critic, or orchestrator and picks the least expensive intelligence level whose ranked examples clear the role's bar, using Essential's intelligence-levels mapping. You can pin a level with the --intelligence flag or confirm the recommendation interactively.

Can I skip the confirmation prompts when creating an agent?

Yes. Pass --yes to accept every recommended setting without prompting, or pin individual settings with --plugin, --intelligence, and --permission flags, which skip only their corresponding prompts. No file is written until the confirmation gate resolves.

Why does create-agent reject my new role request?

Rejection happens when the role duplicates an existing agent's trigger surface, the outcome is unclear, the name is not a role-only lowercase-kebab identifier, the name is personalized, or the authoritative template is missing. Overlapping roles are routed to update-agent instead.