SuperAPI AI Directory

julian-writing

Writing & research

View repository

Updated 10-16 07:26

About this skill

Writing Well

Your favorite authors' first drafts are bad too. The difference is they rewrite. This skill is the rewriting process, plus the two steps before it that decide whether there's anything worth rewriting.

Here's the whole framework in one line:

Writing quality = Novelty × Resonance

Novelty is an idea that's new and worthwhile. Resonance is how that idea takes root in a reader's mind. The first draft is for novelty. Every draft after it is for resonance.

The process

  1. Choose a topic. Pair an objective with a motivation.
  2. Write the intro first. Use it to find your hooks.
  3. Get the intro scored. Rewrite until it's an 8.
  4. Outline from your objective.
  5. Speedrun a terrible first draft.
  6. Rewrite for clarity, then succinctness, then intrigue.
  7. Cycle between rewriting, resting, and feedback until 7.5+.
  8. Copy edit for voice, word choice, and flow.

If you're an agent with no human to score you, be the harshest scorer you can. Then do the future-self trick below. Don't skip the scoring step because it's inconvenient.

1. Choose the topic

The best topic is the one you can't not write about. It's the idea bouncing around your head that compels you to get to the bottom of it.

Step one: pick an objective.

  • Open people's eyes by proving the status quo wrong.
  • Share a solution to a tough problem.
  • Distill an overwhelming topic into something approachable.
  • Tell a suspenseful, emotional story that imparts a lesson.
  • Articulate what everyone's thinking but no one is saying.
  • Identify key trends, then use them to predict the future.
  • Contribute original insights through research and experimentation.

Step two: pair it with a motivation.

  • Does this get something off your chest?
  • Does it reason through a nagging, unsolved problem?
  • Does it persuade others to do something important?
  • Do you obsess over this and want others to geek out too?

Objective clarifies what you're doing. Motivation makes sure you finish. Writers missing either one tend not to finish.

If the pairing isn't coming, write like a diary until an objective emerges. Then do a full rewrite with that objective as your guiding light.

2. Write the intro first

Write the intro before anything else. Intros are how you find novel ideas.

An intro is the minimal information needed to do two things: show the breadth of the post so readers can decide if it's for them, and hook them into reading more.

A hook is a half-told story

You raise a question, then tease only part of the answer.

  • Narrative — Share the start of a profound change, withhold the conclusion. "That was the day I lost everything. This is the story of what happened next."
  • Research — Share a fascinating finding, but only a portion. "80 of them live normal lives. The remaining 10 are defying everything we know about survival."
  • Argument — Make a bold claim, withhold how you got there. "There's a 90% chance Cloudtex goes bankrupt within thirty days."

A hook is not a gimmick. A great opening buys goodwill. Buy enough and readers look past the weaker parts of your post because they're chasing the high from your opening.

And here's the useful flip side: every good hook is also a novel idea you now have to write. Hooks force novelty.

How to generate hooks

  1. Ask: "If someone else wrote my intro, what are the most captivating questions they could pose to make me excited to read this?"
  2. Write those questions down, even without answers.
  3. Rank them by how much they interest you.
  4. The top ones become your hooks. Pose them, don't answer them.

Anything can be interesting when framed by an intriguing question. The questions don't need to be jaw-dropping. They need the target reader to think, "This won't be boring."

The spine of an intro

  • Establish shared context.
  • Surface a problem and what's at stake.
  • Explore why it matters.
  • Tease a clever solution.

Asking a question isn't enough. Readers need a reason to care about the hook. Connect it to a problem they actually have. Failing to do this is where most intros go wrong.

Combat skepticism

A hook pulls readers in. Skepticism pushes them out, and it usually wins. Counter it in the intro.

  • Superficial — "You'll tell me things I already know." → Tease your original insights.
  • Irrelevant — "You won't cover what I care about." → List what you'll cover.
  • Sloppy — "I don't want to sit through bad writing." → Rewrite the intro to be clear and short.
  • Implausible — "You won't deliver on that hook." → Quote authorities, cite evidence, or say plainly you have nothing to sell.
  • Untrustworthy — "You're not qualified." → Share credentials if you have them. If not, be upfront and frame the post as an exploration.

Score the intro

Show only the intro to people who represent the audience. Ask two things:

  • "Rate this 1 to 10 on how interested you are in reading more. You can't pick 7. Pick 6 (meh) or 8+ (good)."
  • "If you were writing this, what questions would you most want answered?" Their best questions become new hooks.

Tell them a low score spares you from writing something no one reads. Rewrite until you hit 8. Don't chase higher. Nothing is fascinating to everyone.

3. Outline from the objective

An outline holds two kinds of points:

  • Supporting points — What's needed to make the argument?
  • Resulting points — What are the implications of the argument being true?

Convince readers, then open their eyes. Supporting first, resulting last, but there's no single correct outline.

Example, for prove the status quo wrong:

  1. State that the reader's current view is false. (supporting)
  2. Show how so many people being wrong hurts. (supporting)
  3. Establish what it takes to change everyone's view. (supporting)
  4. Predict how the world differs after the transition. (resulting)
  5. Explore the exciting byproducts. (resulting)

For distill a complex topic: benefits of understanding it → your credibility → the breakdown → how readers benefit now.

For share a solution: why it's hard → benefits of your solution → walk through it → how to implement → what changes if more people did.

For a story with a lesson: half-told hook → narrate → the lesson → why the reader should care.

Keep the outline specific enough to give structure and loose enough not to confine thinking. When you feel a tug away from it, follow the tug. Prune later.

4. Speedrun the first draft

Write a terrible first draft as fast as you can. Blast through the laziness and get garbage onto the page. This shortcuts you to rewriting, which is far less painful. It's strange how well this works.

  • When stuck, write <to fill out> and move on.
  • Don't try to be original yet. Start with imitation and iterate toward origination.
  • Don't write in order. Start with the three paragraphs that interest you most.

You write in order to think. Most of your ideas arrive while writing, not before. Ideas bubble up from your hooks, your experience, research, experiments, brainstorming, and mental models.

Which ideas are good?

Keep what's interesting or surprising. Those are the ingredients of novelty:

  • Counter-intuitive — "I never realized the world worked that way."
  • Counter-narrative — "That's not how I was told it worked."
  • Shock and awe — "I would never have believed that."
  • Elegant articulation — "I couldn't have said it better."
  • Makes someone feel seen — "That's exactly how I feel."

You are a proxy for your reader. Make your next point whatever interests you most and skip whatever bores you. If it bores you, it bores them.

To find surprise, use Paul Graham's method: learn the basics of a topic first. Then whatever surprises your now-knowledgeable self will surprise laypeople too.

When ideas stop flowing, ask two questions and follow whichever answer is more interesting:

  • How can I make this point more convincing?
  • What are the interesting implications of what I just said?

Conclusions

Optional, but useful. Re-read the piece and ask, "What was this really about?" Distill it into one punchy sentence. Then tell readers where to go next to continue the journey.

5. Rewrite

The enemy of rewriting is being precious about what you first said and how you said it. Your first draft got the ideas out. Now find the right puzzle pieces in the mess and put them in the right order.

Rewrite in this sequence. Each pass makes the next one easier.

Pass 1: Be understood

Write sentences a thirteen-year-old could follow. Not the nuance, the logic. If they can follow it, so can a skimmer.

Two tools:

Plain phrasing. Remove abstract words and replace concepts with specific examples.

Before: "The obstacle facing media organizations is charting an economically sustainable course through a landscape of commodity journalism."

After: "News companies are struggling to stay in business because anyone with a Twitter account can report the news now."

Don't over-simplify into "News companies are not doing well today." That drops the why. Simplify the sentence, keep the nuance.

One idea per sentence. You only understand a sentence once you've finished it. Two ideas per sentence means holding twice as much in your head.

Before: "Ongoing efforts to further characterize the multitude of functions of gut bacteria and the mechanisms underlying its interactions will provide a better understanding of the role of the microbiome in human health and disease."

After: "We're quickly learning which roles gut bacteria play. Researchers want to understand how these bacteria affect our health."

When you keep your language simple, you can get away with making your ideas infinitely complex.

Examples. Give bad examples next to good ones. Before-and-after pairs show what you mean and what you don't. If an example has many moving parts, consider a diagram.

Pass 2: Be concise

Readers quit not because they dislike your ideas. They quit because they're bored.

Succinctness is a ratio: significant thoughts divided by all thoughts. A 50,000-word post can be succinct. Words are free for the writer and costly for the reader.

Three steps:

  1. Rewrite whole sections from memory. Read a section. Take a break. Rewrite it without looking, keeping only the critical points. Fluff falls away. Or have someone summarize your draft aloud in thirty seconds, delete the draft, and rebuild from their summary.
  2. Remove unnecessary detail. Sentence by sentence, cut words that add no context. Cut ideas that aren't central. Don't describe what needs no describing.
  3. Rephrase each paragraph from scratch. Now that you know what you're saying, say it again shorter.

Here's the three steps run on one paragraph:

Original (5 sentences): "To be brief on the sentence-level, you should remove filler words that don't add necessary context to the sentence. This isn't intuitive to novice writers: these extra words cause readers to unwittingly slow down and do extra work while reading. That makes it harder for them to recognize the sentence's true point. Reading many extra words is also a chore for your brain. And when you exhaust readers, they quit reading."

After cutting: "To be brief, remove words that don't add necessary context. Extra words cause readers to slow down. That makes it harder to recognize the point. And when you exhaust readers, they quit."

After rephrasing: "Your sentence is brief when no more words can be removed. Filler buries your point and bores readers into quitting."

A deliberate writer asks of every sentence: what effect does this have on the reader's mind? Is there something more useful I could say instead?

The tweet test. Try compressing the whole post into a single tweet. If you can without losing anything important, publish the tweet instead. If it takes several tweets, you have something meaty.

Pass 3: Be intriguing

Clarity and succinctness let ideas resonate. Intrigue is what keeps people reading in the first place. Take what made the intro hooks work and spread it through the whole piece.

Novelty, distributed. Have readers highlight every sentence that gives them a dopamine hit: "Ahh, that's cool." Tally the hits at the end of each sentence, like this (3). Find long stretches with zero hits. Either shorten them or inject insight and surprise. Repeat until the cadence is steady.

Withholding. Storytelling is choosing what to withhold. Decide which answers you're saving for the end.

Two principles make this a formula:

  • The hook principle: a captivating intro buys goodwill, so readers forgive a weaker middle.
  • The peak-end rule: people judge an experience by its most intense moment and its ending, not the average.

So the trifecta of intrigue:

  1. A captivating intro.
  2. At least one peak of insight or surprise. Condense your most surprising points into one section and build that climax.
  3. An ending that justifies why the piece was worth reading.

Not every paragraph has to be interesting. Take comfort in that.

6. Feedback

Feedback is the most efficient way to improve. It is not optional.

Ask readers from your target audience to read slowly and transcribe their reactions:

  1. Tell me what to delete. "I'm drifting here. Get to the point."
  2. Tell me what to double down on. "Dopamine hit. Go further. I have more questions."
  3. Score it 1 to 10 on how satisfying it was. Low scores spare me from publishing bad work.

Rewrite until the average is 7.5+. Don't chase 9. One reader's 9 isn't another's, and satisfying everyone bloats the post until it satisfies no one.

Incorporating feedback:

  • If you agree, implement it.
  • If 3 of 10 say the same thing and you're ambivalent, do it if it's quick.
  • If 4+ of 10 say the same thing and you disagree, you're wrong. Ask them why.

Feedback from your future self. Your best editor is you with hindsight. Take a break long enough to forget the piece. A week works. Stephen King uses six. Switching editors helps too: a different font and layout kicks your brain out of pattern-recognition and makes it read like someone else's work. With fresh eyes you'll catch awkward sentences, weak persuasion, dead stretches, and bloated sections.

Done means: the objective is fulfilled, the score is 7.5+, and rewrites are no longer producing significant edits.

7. Style

Style is voice, vividness, imagination, and presentation.

Voice is your unfiltered self on paper. Not word choice. Tone, humor, eccentricities, viewpoints. Write like you talk to a lifelong friend, then remove sensitive details in a later draft. Inauthentic voice comes from absorbing someone else's style, projecting expertise you don't have, or "writing smart" with words like plethora and myriad. If you don't say it in conversation, don't write it. Record yourself talking and work from the transcript.

Vividness is detail that resonates, not just detail. It's articulating the rarely-articulated nuances of life so a reader thinks, "That's how I'd put words to that feeling." Word choice does most of the work: shrieking sirens, tired gears, coy flames. Uncommon words in a context where their meaning is still clear.

Imagination. Poetry is saying meaningful things in evocative, unconventional ways. Describe the effect instead of the thing:

  • First-order: The day was hot.
  • Second-order: The day melted our popsicles.
  • Third-order: Even the bugs were looking for air conditioning.

Each step removed makes the reader assemble the image themselves. That's engagement instead of spoon-feeding.

Presentation. Would an analogy, an anecdote, a diagram, or a joke carry this idea better? Then use it.

Copy editing

  • Paragraphs of five sentences or fewer. White space lowers the perceived workload and gives readers places to pause.
  • Verbs that embed their adverbs. "She spoke loudly" is "She shouted."
  • Adjectives and adverbs only when they add something important.

When you're stuck

  • No good ideas. Note what you strongly disagree with, then argue the counter-position. Write down a vulnerable story you'd tell a close friend. Keep a backlog of every surprising thing you read. Explain concepts to someone and notice when you articulate something beautifully.
  • No one will read it. Write to clarify your own thinking. Readership is a bonus. Great authentic content surfaces over time.
  • Fear of judgment. Add a disclaimer: "Early thoughts. Tell me where I'm wrong." Or curate others' ideas and slowly increase your own share. Some shamelessness about being wrong in public is required. Too much and you're a charlatan. Too little and you never publish.
  • Procrastination. Remove the internet. Write any three paragraphs fast; momentum carries. If it persists for months, the topic isn't one you care about enough.

The three tests

Keep rewriting until all three pass.

  • Writing is clear once your ideas are self-evident.
  • Writing is succinct once everything low-value is removed.
  • Writing is compelling once the reader effortlessly makes it to the end.

There's no right way to write, just like there's no right way to paint. Break every rule here if the result is still useful or interesting.

Source: Julian Shapiro, Writing Well handbook, julian.com/guide/write.