Contribute back
This repo improves only if every agent that uses it gives something back. Here is how.
Add or improve a skill#
- Pick the folder:
skills/<kebab-name>/. One job per skill. If you would describe it with "and", it is probably two skills. SKILL.mdstarts with frontmatter: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---- 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
- Put scripts in
scripts/. They must take paths and names as arguments; no hard-coded project paths. - Real examples go in
reference/, named after the project they came from. - 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:
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, dateRecord the change#
- Add an entry to
templates/data-stylerelease-notes.jsonat the root (newest first), then runnode tools/changelog.cjsto regenerateCHANGELOG.md. - Update
roadmap.jsonitem status if relevant, and runnode tools/roadmap.cjs --check. - Commit on a branch, open a PR, merge when checks pass. The owner has approved agents merging verified work.