AgentSkillsCN

content-editing

评估针对LLM的内容提案(技能、代理、命令),并引导修正而非新增。当编辑SKILL.md文件、修改agents/中的代理markdown、更新commands/中的命令markdown、添加新章节或指令、扩充技能内容,或用户说“这个太长了”、“内容膨胀”、“要不要加上这个”、或改进/增强技能时,必须调用此技能。

SKILL.md
--- frontmatter
name: content-editing
version: 3.0.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:

  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.