SKILL.md
Writing Enhancement
Transform and improve written content for clarity, style, and correctness.
Pattern Selection
| Intent |
Pattern |
When to Use |
| General improvement |
improve_writing |
Enhance clarity, flow, style |
| Academic writing |
improveacademicwriting |
Scholarly tone, citations, structure |
| Fix errors |
fix_typos |
Spelling, grammar, punctuation |
| Clean formatting |
clean_text |
Fix breaks, normalize punctuation |
| Analyze quality |
analyze_prose |
Rate novelty, clarity, style |
| Pinker analysis |
analyzeprosepinker |
Steven Pinker's clarity principles |
| Make approachable |
humanize |
Technical → conversational |
| Essay (styled) |
write_essay |
Essays in specific author styles |
| Essay (PG style) |
writeessaypg |
Paul Graham essay style |
| Micro essay |
writemicroessay |
Concise single-idea essays |
| Academic paper |
createacademicpaper |
Full LaTeX academic papers |
| LaTeX output |
write_latex |
LaTeX document formatting |
Decision Flow
User request
│
├─ "fix/correct/proofread" ──→ fix_typos
├─ "improve/enhance/better" ─┬─ academic context? ──→ improve_academic_writing
│ └─ general ──→ improve_writing
├─ "analyze/rate/evaluate" ──→ analyze_prose (or analyze_prose_pinker)
├─ "humanize/simplify" ──→ humanize
├─ "write essay" ─┬─ specific author? ──→ write_essay
│ ├─ Paul Graham? ──→ write_essay_pg
│ └─ short/micro? ──→ write_micro_essay
└─ "academic paper/LaTeX" ──→ create_academic_paper or write_latex
Pattern References
See references/ for full patterns:
- [improvewriting.md](references/improvewriting.md)
- [improveacademicwriting.md](references/improveacademicwriting.md)
- [fixtypos.md](references/fixtypos.md)
- [analyzeprose.md](references/analyzeprose.md)
- [humanize.md](references/humanize.md)
- [writeessay.md](references/writeessay.md)
Output Guidelines
- Preserve the author's voice unless asked to change it
- For corrections: show changes or provide clean version based on preference
- For analysis: provide actionable feedback, not just ratings
- Match formality level to context (academic vs. blog vs. email)
Chaining Suggestions
- After
analyzeprose → offer improvewriting to address issues
- After
improvewriting → offer fixtypos for final polish
- After
humanize → offer analyze_prose to verify accessibility