| name | content-editing |
| version | 3.4.0 |
| description | Evaluates proposed changes to LLM-targeted content (skills, agents, commands) and guides toward corrections over additions. MUST invoke when editing SKILL.md files, modifying agent markdown in agents/, updating command markdown in commands/, adding new sections or instructions, expanding skill content, user says "is this too long", "content bloat", "should I add this", or improving/enhancing skills. |
Content Editing for LLM
Enforce the principle: prefer correcting existing content over adding new instructions.
Core Principle
Undesired behavior stems from incorrect information, not missing information. Adding more instructions increases complexity without addressing root causes. Shorter is better.
Decision Framework
Before adding new content, ask:
- Does existing content already address this behavior incorrectly?
- If YES: Correct the existing content instead of adding
- Can the issue be fixed by clarifying or rewording current instructions?
- If YES: Modify existing wording instead of adding
- Would adding content create redundancy or conflict with existing guidance?
- If YES: Consolidate or remove conflicting content first
Only add new content when ALL conditions are met:
- The capability genuinely doesn't exist in current instructions
- Existing content cannot reasonably be extended to cover the case
- The addition addresses a distinct, orthogonal concern
When Addition is Warranted
If adding is truly necessary:
- Consider progressive disclosure - move detailed content to
references/
- Consider agent delegation - split responsibilities into focused agents
- Keep additions orthogonal - distinct from existing content
Balance is key—additions are appropriate when they fill genuine gaps.
