Skills & docs authoring
Create and continuously improve the skills and docs your agents rely on
Every skill and doc you add is reloaded into the agent's context over and over, and verbose ones get skimmed or ignored. These three skills keep your skills and docs compact and effective, and turn every correction into a lasting lesson.
compact-docs-writer
Rewrites a doc, or drafts a new one, to carry every rule and intent in the least text possible. You get a measured word delta proving nothing was lost, and the diff is applied only after your approval.
compact-skill-creator
Creates or edits skills on top of compact-docs-writer, adding the skill-specific craft: a sharp description (the most expensive text, loaded in every session), the right trigger type, and progressive disclosure.
self-improve
When the agent makes a mistake or doesn't behave the way you want, this skill captures the lesson as a diff to the skill or doc that should have prevented it. You approve where it lands, and the mistake doesn't repeat.
Opinionated rules that support this approach
Optional and not installed by default: three rules that support this authoring approach.
- compact-governing-docs every edit to a skill or governing doc goes through the compaction skills first. Read the rule →
- self-contained-docs planning docs carry everything a fresh session needs, and nothing more. Read the rule →
- self-improve-on-correction when you correct the agent on something a doc governs, it offers to capture the lesson with /self-improve. Read the rule →