Agent Builder
Scaffold and improve Claude Code agents. Create a new Trinity-compatible agent from scratch on any topic, or audit and improve an existing agent with targeted before/after changes across 9 best-practice areas.
Installation
/plugin marketplace add abilityai/abilities /plugin install agent-builder@abilityai
Usage
# Scaffold a new agent /create-agent /create-agent "PR review bot for Python data pipelines" # Review and improve an existing agent /adjust-agent /adjust-agent ~/my-agent
What It Creates
my-agent/
CLAUDE.md # Agent identity, instructions, and plugin setup guide
template.yaml # Trinity metadata (name, description, avatar)
.env.example # Environment variable template
.gitignore # Credentials and runtime exclusions
.mcp.json.template # MCP server config template
.claude/
skills/ # Initial skills based on agent purpose
skill-one/SKILL.md
skill-two/SKILL.md| File | Purpose |
|---|---|
| CLAUDE.md | Tailored identity, behavioral instructions, and plugin setup guide |
| template.yaml | Trinity metadata (name, description, avatar) |
| .env.example | Environment variable template |
| .mcp.json.template | MCP server config with placeholders |
| .gitignore | Credentials and runtime exclusions |
| .claude/skills/ | 2-4 initial skills based on the agent's purpose |
Skills
| Skill | Description |
|---|---|
| /create | Discovery entry point — lists all available creation paths (wizards, clones, scaffolders) and routes to the right one |
| /create-agent | Scaffold a new Trinity-compatible Claude Code agent from scratch on any topic |
| /adjust-agent | Review an existing agent against best practices and apply improvements — proposes specific before/after changes, then applies approved edits |
How /create-agent Works
The creation wizard guides you through these steps:
1.Describe your agent — What it does, who it serves, what problems it solves
2.Name it — Short, memorable, lowercase-with-hyphens
3.Choose starting skills — 2-4 initial capabilities
4.Select plugins — Which marketplace plugins to reference in setup docs
5.Review and create — Everything is generated and committed
6.Create GitHub repo — Optionally create a public or private GitHub repository via
gh CLIHow /adjust-agent Works
The adjustment wizard audits an existing agent across 9 best-practice areas and proposes exact before/after changes for approval:
1.Identity — Named, purposeful, audience-aware
2.Capabilities — Listed, linked to skills, with when-to-use guidance
3.Artifact dependency graph — Artifacts declared, directions set, skills mapped
4.Recommended schedules — Automatable skills scheduled with cadences
5.Guidelines — 2-4 domain-specific actionable rules
6.Skill docs — CLAUDE.md in sync with .claude/skills/
7.Skill quality — Valid frontmatter, minimal permissions, clear steps
8.Trinity readiness — template.yaml, .env.example, .gitignore, .mcp template
9.Project hygiene — Git initialized, no secrets, naming convention
The Generated Agent
The agent's CLAUDE.md includes:
•Full identity and behavioral instructions tailored to the topic
•Skill documentation with slash commands
•Instructions for creating new skills using the playbook pattern
•Plugin installation guides for Trinity deployment, memory, and more
•Project structure reference
Extending the Agent
After creation, open the agent in Claude Code and:
# Install playbook-builder for new skills /plugin install playbook-builder@abilityai /create-playbook # Deploy to Trinity /plugin install trinity-onboard@abilityai /trinity-onboard
Related Plugins
| Plugin | Purpose |
|---|---|
| playbook-builder | Create and manage skills |
| trinity-onboard | Deploy agents to Trinity |
| json-memory | Persistent memory across sessions |
| install-cornelius | Install the Cornelius reference agent |