skills/drafting-writing/SKILL.md
Writing-partner processes that draw out the user's own writing through questioning: guided drafting sessions, fragment mining, shaping raw material into a piece, and phrase tightening. Use for help discovering, developing, and structuring writing (notes, essays, messages, etc).
npx skillsauth add nweii/agent-stuff drafting-writingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Help the user discover and sharpen what they want to say and how they want to say it without doing it for them. Critique ideas freely when they feel hollow, unclear, or if they could use more intentionality.
When the user is stuck or vague about what they want to say or what the reader needs, ask context-informed questions that help unblock them. You should know or learn their material, their angle, and their reader. Use that context to make questions specific and relevant, the kind that helps surface an insight or direction for the user.
Writing is recursive. Move fluidly between clarifying the core, surfacing texture, testing angles, finding structure, and drafting—at any scale (whole piece, section, paragraph, single claim) and at any stage (whether the page is blank, a pile of material exists, or a draft is being reworked). You might clarify a thesis, surface concrete examples, then realize the thesis needs rethinking based on those examples.
The question banks for each movement live in question-modes.md. Working habits for any session:
Default to a freeform session (conversing through the question modes, proposing draft text in the chat).
Sometimes a narrower format is more useful:
If a freeform session turns out to be pure pre-structure ideation, switch to fragment mining; if material already exists and the work is arranging it, switch to shaping.
Fragment mining and shaping each build a markdown file the user edits alongside you. For both:
For sentence-level editorial discipline (rhetorical crutches, compression, cadence, word choice), defer to whatever voice guidelines are already in context: a dedicated voice or editorial skill if one is loaded, a project's style conventions, or the register of the surrounding material. When none exist, default to plain spoken language that sounds like the original writer, just sharper.
testing
Command-invoked tutoring pass for understanding something deeply: a concept being learned, or work just done in the session. Locates where the learner is, teaches one step per turn, quizzes to verify, and continues until they can explain the material back and apply it. Can produce durable artifacts (a walkthrough of the work, a record of what was learned, a glossary) saved through whatever the environment supports. Best run after substantive work, or when the aim is to learn something.
testing
Search, read, filter, combine, adapt, and save recipes in the Brain vault collection. Use whenever cooking and the collection are relevant — 'what should I make', 'recipes with miso', 'save this one' all imply it.
testing
Socratic teaching pass over the work just done in a session: incremental comprehension stages, a running checklist doc, restate-understanding-first, and AskUserQuestion quizzes. The session doesn't end until the user has demonstrated understanding. Run after Claude has completed substantive work worth deeply understanding.
development
Plan, write, review, and maintain software tests. Use when building features or fixing bugs test-first with a red-green loop, writing or rewriting unit/integration/e2e tests, reviewing or auditing test quality, choosing what level of test to write, working with mocks and fixtures, or keeping an existing suite in mind while making code changes.