Contribute

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

1. Add your file

Drop your file under one of:

• registry/skills/<name>/SKILL.md — behavioral skill (markdown with frontmatter)
• registry/tools/<name>/<files> — tool configurations
• registry/rules/<name>.md — single-file coding rule

For skills, the frontmatter is:

---
name: my-skill
description: Use when ... (one-line trigger description)
---

# My Skill

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 (~80+ lines for skills, 40+ for rules)
• No filler — every paragraph should be load-bearing
• Concrete examples, not abstractions
• Frontmatter description actually says when to use the skill
• Tags overlap with the CLI's stack detection so it auto-installs for the right projects

Read the full contributing guide