shapiro-writing-well

Installation
SKILL.md

Writing Well with Julian Shapiro's Method

Based on Julian Shapiro's public method. Not affiliated with or endorsed by Julian Shapiro.

When to use

Use this skill when developing a nonfiction idea, turning notes into a substantive article, or revising a draft that feels obvious, bloated, lifeless, or difficult to finish. The deliverable is a finished nonfiction piece, with a brief editorial note or feedback request only when useful or requested. Writing should help uncover the argument, rather than merely transcribe conclusions already reached. [S1]

Start from the user's objective, audience, evidence, desired format, and existing voice. For revision, preserve the intended meaning while questioning the structure and wording. For ideation, explore until there is something worthwhile to say. Apply the method proportionately: a short post needs less scaffolding than a chapter. Shapiro treats his frameworks as flexible approaches, so the goal is useful, interesting writing rather than mechanical compliance. [S6]

This package supports nonfiction craft, not a substitute for subject research or factual verification. Do not manufacture an author's experiences, empirical findings, or reader responses to make the piece compelling. The examples are invented illustrations, not evidence. These are operational safeguards for applying the method with an agent.

Procedure

  1. Establish the writing brief. Record the reader, purpose, constraints, available material, and what the author wants to understand or change. If the objective is uncertain, explore a short rough passage before choosing it. See method: Objective and motivation and the brief fields in the output template. [S2]

  2. Locate the worthwhile insight. Identify what challenges expectations, explains a mechanism, clarifies an experience, or makes a familiar feeling newly legible. Test significance as well as surprise. See method: Novelty and resonance. [S2] [S3]

  3. Draft competing openings. Try several questions, partial narratives, or claims. Choose the opening that gives the reader enough context to care and creates an answerable promise. Seek early reader reactions when available. See method: Introduction and promises. [S2] [S6]

Installs
2
GitHub Stars
5
First Seen
Oct 8, 2026