create-sub-agentlisted
Install: claude install-skill richfrem/agent-plugins-skills
Follow the `create-sub-agent` skill workflow to design and generate a Claude Code agent file.
## Inputs
- `$ARGUMENTS` — optional agent name or brief use-case description passed as initial context
to the design interview. Omit to start with open discovery.
## Steps
1. If `$ARGUMENTS` is provided, use it as the starting context for agent name / purpose
2. Follow the create-sub-agent phased workflow: extract core intent via design interview
(purpose, input/output contract, escalation posture, tools, permissions.deny, model,
maxTokens, color, lifecycle hooks, placement), present design summary, confirm,
then generate the agent `.md` file
3. Validate the generated agent with `validate_agent.py`
4. **Publication Check**: Ask if the agent should be visible to GitHub Copilot or Claude Code for this repository. If yes, materialize it into `.github/agents/` or `.claude/agents/` and ensure the path is tracked in `.gitignore`.
5. Report the created agent path, triggering conditions, and next steps
## Output
Agent `.md` file with complete YAML frontmatter (name, description with `<example>` blocks,
model, maxTokens, color, permissions.allowedTools, permissions.deny) and a second-person
system prompt targeting 500-3,000 characters.
## Placement Rules
**Plugin agents**: flat `.md` file — `plugins/<plugin-name>/agents/<agent-name>.md`
- **No subdirectory.** Skills use `skills/<name>/SKILL.md` subdirectory format, but agents do NOT.
- Confirmed against Anthropic official p