Writing
Skill justinramos101/agent-skill-kit/skills/.experimental/writing
Battle-tested Agent Skills for coding agents — source-grounded, failure-driven heuristics that audit and design real surfaces. Install with npx skills.
npx -y skills add justinramos101/agent-skill-kit --skill writingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use to write or fix prose in either direction. Existing draft: tighten wordy lines (revise), fix mechanics, grammar, and consistency while preserving voice (copyedit), or diagnose why a piece drags, buries the point, or fails to land. New piece: structure an argument or memo (PRD, RFC, recommendation), organize a task-oriented technical doc, get a rough first pass down without stalling, or give a talk, pitch, or narrative a persuasive arc. Triggers: 'tighten this', 'copyedit this', 'review my draft', 'why does this drag', 'help me outline this RFC', 'draft this announcement', 'make this pitch land'. Do NOT use for docs-as-product-surface work (a doc set's IA, retrieval, navigation, or README/quickstart design), for reviewing UI copy as a usability surface, for code comments or docstrings, or for visual/slide design.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
3.3 KB, as published. Nobody here has run it
Writing
Infer what the prose needs from the request — never ask which mode:
- Existing draft → revise, copyedit, or diagnose. Load
references/revising.md. - New piece → structure, draft, or persuade. Load
references/drafting.md. - Genre identifiable — memo (PRD/RFC), technical doc, talk/pitch, narrative? Also load
references/genres.md.
Core principle: serve a named reader, not taste. Critique: every finding names a concrete reader, the cost it inflicts ("a scanner can't find the ask"), and a fix; a preference-only note is labeled preference or dropped. New work: decide what the reader needs before polishing how it reads — most weak writing is a structure or audience problem wearing a sentence-level disguise.
Invariants
- Narrative honesty — never let persuasion bend facts. Apply narrative or persuasive shape only where the tension is real: no invented stakes, villains, or crises; a reversal must reflect an actual change of fortune; "because of that" must reflect actual causation. Before any dramatic beat, ask: is this tension already in the material? If not, cut the beat. Genuinely additive content gets answer-first structure, not a forced arc.
- Voice guard — tightening is triage, not dogma. Keep hedges that encode calibrated uncertainty ("we think X" ≠ "X"); keep deliberate rule-breaking that aids clarity; a cut that changes meaning or register is offered with the trade-off named, never imposed. If every writer comes out sounding identical, the edit failed.
- Report a before/after word ratio on every tightening pass.
Workflow
- Assess. Existing prose or new? Which intent — revise / copyedit / diagnose / structure / draft / persuade — and which genre? State the inference; proceed.
- Load only the matching reference(s).
- Apply the named heuristics that fit: answer-first, SCQA, MECE, given-before-new, curse-of-knowledge scan, ABT spine, grunt test, does-this-section-turn. Honor both guards.
- Emit the revision or draft with rationale: target reader, heuristics applied, reader cost per finding or the load-bearing structural choice, word ratio where relevant.
Run to completion; state assumptions inline. Ask only on a genuine blocker: no text supplied and no topic to draft from. Stop after one emission — a second pass only if your own diagnostics still flag a point-burying miss; never a third.