AGENT SKILL

shapiro-writing-well

Develop and revise nonfiction using Julian Shapiro's public Writing Well method. Use for essays, articles, blog posts, and nonfiction chapters that need stronger insights, curiosity, clarity, concision, and an authentic voice.

License 许可
Apache-2.0
所属仓库
getedgehq/skills
最近更新
2026-11-12
Stars
★ 5
Forks
0

01 前言 Front Matter

name
shapiro-writing-well
description
Develop and revise nonfiction using Julian Shapiro's public Writing Well method. Use for essays, articles, blog posts, and nonfiction chapters that need stronger insights, curiosity, clarity, concision, and an authentic voice.

02 资源文件 7

03 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]

  4. Build a flexible outline. Turn the opening's questions into talking points. Separate prerequisites and supporting reasoning from consequences. Leave room for discoveries that improve the direction. See method: Exploratory drafting and the output template. [S3]

  5. Generate before polishing. Fill the outline quickly; use explicit placeholders for missing support. Develop weak ideas enough to diagnose their shortcomings, then try stronger alternatives. See method: Exploratory drafting and worked examples. [S3] [S7]

  6. Repair reasoning and clarity. Identify each section's actual claim, evidence, and connection to the objective. Replace abstraction with concrete explanations and fewer ideas per sentence, while preserving nuance. See method: Clarity and reasoning. [S4]

  7. Rebuild, then compress. Reconstruct sprawling sections around their essentials before trimming individual words. Rephrase paragraphs and test whether the idea earns the requested length. See method: Succinctness and the compression notes in worked examples. [S4]

  8. Arrange curiosity and payoff. Strengthen the opening, concentrate the strongest insight into a recognizable peak, and end by showing what the reader gained. Resolve every important promise. See method: Intrigue and narrative. [S4] [S8]

  9. Add resonance in the author's voice. Use a relevant example, analogy, anecdote, or vivid detail where it improves understanding or emotional recognition. Remove borrowed mannerisms and decoration. See method: Voice and vividness. [S5]

  10. Use feedback honestly. Request reactions from intended readers when possible. Revise confusion, dull stretches, and underdeveloped discoveries; stop chasing universal approval. If feedback is unavailable, mark that check pending. See method: Feedback and stopping and the review checklist. [S4]

  11. Copy edit and deliver. Check punctuation, word choice, paragraph weight, unresolved placeholders, and factual boundaries. Run the review checklist, then present the piece using the output template, omitting planning fields from reader-facing copy. See method: Copy editing. [S6] [S9]

Files in this skill

04 同仓库更多 Skills

getedgehq
getedgehq/skills

zero-downtime-cloud-move

Runbook for moving a live app from one cloud to another (Google Cloud to AWS, AWS to Google Cloud, a PaaS to your own account, or one storage provider to another) without downtime. The agent inventories what is really running, builds the new stack next to the old one, keeps a one-line rollback for every phase, proves the new stack with real workloads before any traffic moves, cuts over with a checklist, watches a fixed window after the switch, copies data with an idempotent job whose second pass must report 0 left, and deletes the old cloud last. Use when someone asks to migrate, move or replatform a production app, switch cloud providers, move a backend, database files or object storage, plan a DNS cutover, or decommission an old cloud account.

★ 5
getedgehq
getedgehq/skills

zayats-ceo-branding

Build an evidence-based CEO positioning paper, Personal Branding Roadmap, and editorial workflow using Marina Zayats's public method. Use for executive branding, LinkedIn ghostwriting briefs, profile strategy, and recurring CEO-approved content planning.

★ 5
getedgehq
getedgehq/skills

yc-app-roast

YC App Roast: roast a YC or a16z Speedrun application. Use when a founder wants their YC or Speedrun answers scored, asks "what would a YC partner think", wants the weak answers found or rewritten, or wants their draft checked before they submit. Scores every answer 0-10 against public advice from YC and Speedrun partners, names the top issue with the exact words that cost points, and writes a rewrite from the founder's own facts. Works for YC and a16z Speedrun. Not affiliated with Y Combinator or a16z.

★ 5
getedgehq
getedgehq/skills

yc-app-review

YC App Review: get a YC or a16z Speedrun application reviewed by people you trust. Use when a founder wants friends, mentors or alumni to review their YC or Speedrun application, or asks to share their draft for feedback. Builds a shareable review page (one HTML file, application-portal look) where reviewers leave notes per question and press "Send my notes" to send them back as text, then parses the notes into proposed rewrites. Optional tracked private links per reviewer. Works for YC and a16z Speedrun. Not affiliated with Y Combinator or a16z.

★ 5
getedgehq
getedgehq/skills

x-growth-playbook

X Growth Playbook. Analyse a person's own X (Twitter) posts and tell them what to post next, with the numbers behind every claim. Compares quote posts vs originals, links vs no links, short vs long, time of day in their timezone, media vs text and the topics they name, reports medians with n, then writes a 10-step plan and the next 7 posts in their voice. Use when the user says "analyse my X posts", "what works on my Twitter", "how do I grow on X", "what should I post next on X", "audit my X account", or shares an X data archive, X API export or a list of their posts. Runs on the user's computer.

★ 5
getedgehq
getedgehq/skills

workplan

Create, update, or close work plans for multi-step tasks. Use when starting refactors, bug lists, feature work, migrations, or any task with 2+ steps. Also use after auto-compaction to re-orient. Triggers: "workplan", "work plan", "create a plan", "what's the plan", "where was I", or when Claude detects a multi-step task that needs tracking.

★ 5