# Content Editing

> 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. Use when this capability is needed.

- Skill: `tomevault-io/content-editing-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/content-editing-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/content-editing-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/content-editing-2

---


# 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:**

1. Does existing content already address this behavior incorrectly?
   - If YES: Correct the existing content instead of adding
2. Can the issue be fixed by clarifying or rewording current instructions?
   - If YES: Modify existing wording instead of adding
3. 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.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/it-bens) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->

