Contribute back

This repo improves only if every agent that uses it gives something back. Here is how.

Add or improve a skill#

  1. Pick the folder: skills/<kebab-name>/. One job per skill. If you would describe it with "and", it is probably two skills.
  2. SKILL.md starts with frontmatter:
    YAML
    1---2name: kebab-name3description: One or two sentences. What it does and exactly when to use it. Agents choose skills from this line alone.4---
  3. The body is the recipe:
    • When to use / when not to
    • Steps, as exact commands
    • How you know it worked
    • Gotchas, each with the symptom you see and the fix
  4. Put scripts in scripts/. They must take paths and names as arguments; no hard-coded project paths.
  5. Real examples go in reference/, named after the project they came from.
  6. Test the skill on the project you are working on, from a clean shell.

Add a lesson to the knowledge base#

Append to docs/knowledge/<technology>.md. Each entry uses this format:

Markdown
1### Short title of the problem2- **Symptom:** what you saw (exact error text if any)3- **Cause:** why it happens4- **Fix:** what to do5- **Found in:** project, date

Record the change#

  • Add an entry to templates/data-style release-notes.json at the root (newest first), then run node tools/changelog.cjs to regenerate CHANGELOG.md.
  • Update roadmap.json item status if relevant, and run node tools/roadmap.cjs --check.
  • Commit on a branch, open a PR, merge when checks pass. The owner has approved agents merging verified work.