| name | update-skill |
| description | Update existing skills while keeping them simple, coherent, and non-duplicative; always recommend the best placement for new rules. |
Update Skill
Use this skill when a user asks to update SKILL.md or AGENTS.md and wants the result cleaner without losing intent.
Goal
Keep instructions short, clear, and non-duplicative.
Integrate updates into the full skill flow, not as isolated add-ons.
Required Rules
- Read the whole target skill file before editing.
- Read relevant related files (for example
AGENTS.md) before editing.
- Place changes where they logically belong; do not append blindly.
- Remove or merge overlaps and repeated wording.
- Keep sections short, headings predictable, and language direct.
- Preserve behavioral intent when refactoring.
Placement Decision (Mandatory)
Recommend the best location before editing, even if the user named a file.
Choose in this order:
- Existing skill, existing section (best).
- Existing skill, new section (if concept is new but belongs there).
- Different existing skill (if concern belongs elsewhere).
- New skill (only if reusable and it does not fit existing skills cleanly).
If the requested file is a poor fit, state:
- Why it is a mismatch.
- Which file is better.
- Whether to move or duplicate (default: move).
Recommend a new skill only when all are true:
- The rule is reusable across multiple skills.
- It defines a distinct workflow.
- Adding it to an existing skill would cause clutter.
Workflow
- Parse the requested update.
- Read all relevant file(s) end-to-end.
- Identify duplication, conflicts, and wording drift.
- Give placement recommendation with rationale.
- Apply edit in the chosen location.
- Refactor nearby text for flow and consistency.
- Run a cleanup pass: deduplicate, normalize terms, tighten sections.
- Report outcome clearly.
Output Requirements
Report:
- Placement recommendation and reason.
- Files changed.
- Cleanup performed.
- Remaining ambiguity and recommended next step.
