Contribute

The AutoAgents registry is community-curated. Anyone can submit a new specialist agent via PR. Three rules: one PR = one agent, write for AI agents (not human readers), and run the checksum regen before pushing.

1. Add your file

Drop your file under:

• registry/agents/<name>.md — specialist agent (markdown with frontmatter)

For agents, the frontmatter is:

---
name: my-specialist
description: Use when ... (one-line trigger description)
tools: [Read, Write, Edit, Bash, Grep, Glob]
---

# My Specialist

Substantive body content. Opinionated. Tell the agent what to do — and what NOT to do.

2. Register it in the manifest

Add an entry to registry/manifest.json. Use sha256:placeholder for both the item and install checksums — the next step computes the real values.

3. Regenerate checksums

node registry/scripts/regenerate-checksums.mjs

4. Open a PR

CI runs regenerate-checksums.mjs --check and rejects stale checksums. Fix locally with the same command and push again.

Quality bar

• Substantive content with concrete operating guidance
• No filler — every paragraph should be load-bearing
• Concrete examples, not abstractions
• Frontmatter description actually says when to invoke the agent
• Tags overlap with the CLI's stack detection so it auto-installs for the right projects

Read the full contributing guide