SKILL.md
Refresh the target artifact as if it were the first clean version.
Goal
The result must be lighter, more current, and more accurate than the input. It should not read like a changelog, cleanup note, or patch over an older draft.
Workflow
- Identify the target artifact from the user's request or the active context.
- Read the target artifact end to end before editing.
- Check nearby artifacts that must stay aligned with it.
- Remove scaffolding residue, stale deltas, duplicated process noise, deprecated information, and over-specific history.
- Fold durable lessons into the place they should have lived from the start.
- Rewrite instead of appending when appending would preserve noise.
- Preserve the artifact's useful voice and structure; simplify everything else.
- Smooth prose noise: fold a parenthetical that interrupts a sentence or list into its own clause or cut it, keep a word or point repeated within reach of itself only once, and unwind padding that adds length but not meaning.
- Smooth source noise: unwrap a hard line break that splits a sentence mid-flow so each paragraph or list item lives on one source line, matching how sibling artifacts format theirs; make a plain-text pointer to a named section or file followable, a link where the medium supports one; leave code, tables, and quoted material as formatted.
- Re-read the result and cut again.