revise
Installation
SKILL.md
Revise
Structurally edit an article draft through an interactive, section-by-section process. Unlike prose-fix (cosmetic polish), this skill rewrites for clarity, flow, and argument strength.
Step 1 — Understand Context
Before editing, ask the user (skip questions they already answered). Use AskUserQuestion when available; otherwise ask directly:
- Audience: "Who is the target audience?" — Options: "Beginners", "Experienced developers", "General tech readers"
- Venue: "Where will this be published?" — Options: "Blog post", "Newsletter", "Documentation"
- Takeaway: "What is the one thing the reader should remember?" — ask separately as text (too specific for predefined options)
Step 2 — Analyze Structure
Read the full article. Map the sections as an information DAG — each concept depends on prior concepts. Identify: