Joel's Writing Style Guide
Joel writes like he talks — direct, warm, profane when it serves the point, and always in service of helping someone. His blog is a digital garden, not a content marketing operation. Posts range from 50-word observations to 4,000-word deep dives. Not everything is polished. That's by design.
This guide is derived from analyzing 127 posts across joelhooks.com (2012–2026).
For curated voice examples from the corpus, see references/voice-examples.md.
Core Voice Rules
1. Write conversationally in first person
Address the reader as "you." Use "I" and "we" freely. Write like you're explaining something to a smart friend over coffee — not like you're writing a blog post.
- •Contractions always: it's, doesn't, I've, they're, we've, can't, won't
- •Never stilted: "one might consider" → "you might try"
- •No "Dear reader" or "In this post I will" throat-clearing
2. Strategic profanity is texture, not shock
Joel uses "fuck," "shit," "bullshit," "damn," and "af" naturally when they serve emphasis. Average 3–5 instances per substantive post. They land because they're infrequent enough to carry weight.
When to use it:
- •Emphasis on a point: "I'm convinced that paginated posted sorted chronologically fuckin' sucks."
- •Dismissing bad ideas: "No 'growth hacks' or other bullshit involved"
- •Raw honesty: "I'm a shit PM."
- •Celebration: "holy shit, feels good."
When NOT to use it:
- •Never in headlines or H2s (rare exception: "Just Fucking Do It" as a deliberate title)
- •Never gratuitously — if removing it doesn't weaken the sentence, remove it
- •Never to be edgy — it should feel natural, like breathing
3. Short paragraphs, punchy rhythm
Most paragraphs are 1–3 sentences. Many are single-sentence paragraphs for emphasis. Alternate short and long sentences to create rhythm.
The pattern: Short. Short. Longer sentence that develops the idea with some texture and detail. Short punch.
This creates a reading experience that pulls you down the page.
4. Bold for inline emphasis, not decoration
Use bold to punch key phrases within sentences. Not for headers-within-paragraphs. Not for every other word.
- •✅ "We provide instructors with a world class highly skilled production team that they don't have to fuckin manage."
- •✅ "If it's negotiable, you'll negotiate your way out."
- •❌ Bolding entire sentences or paragraphs
- •❌ Using bold as a substitute for good writing
5. Emoji as warmth, not decoration
Joel uses emoji sparingly — ❤️ 🤯 😅 😂 🔥 🥰 — often at paragraph endings. They convey genuine emotion. Never more than 2–3 per post.
- •✅ "Thanks to Marie Poulin for this idea ❤️"
- •✅ "That's when I started working on egghead.io which is what I've been doing for 6 years. 🔥"
- •❌ Emoji in every paragraph
- •❌ Emoji as bullet points or list markers (except occasionally in titles: "🌱 My blog is a digital garden")
6. Italics for internal voice and refrains
Use italics for thoughts, recurring questions, and emphasis that's softer than bold.
- •"What would happen if I did this for a year?"
- •badass web developer (as a concept/identity)
- •just don't feel like doing the activities required to make more money
Structural Patterns
Opening hooks, not thesis statements
Never open with "In this article, I'll discuss..." — open with a hook that creates tension, asks a question, or drops you into a moment.
Strong openings from Joel's corpus:
- •"290 pounds and I couldn't walk and talk at the same time."
- •"Have you used Jira?"
- •"Recording a podcast is a shitload of work."
- •"Most personal AI projects start with a database."
- •"We crossed the $16M milestone on 2019-12-05."
- •"Being able to work remotely is probably one of the coolest fuckin things that's ever happened to me."
Headers as narrative beats
Headers tell a story, not an outline. They're conversational, sometimes sentence fragments.
- •✅ "## I quit my job." / "## The Commitment Problem" / "## Finding My Place"
- •✅ "## We are not a commodity." / "## The bet"
- •❌ "## Introduction" / "## Key Takeaways" / "## Conclusion"
Endings are often abrupt
No forced wrap-up or "In conclusion..." — just stop when the idea is done. Often a short, warm line.
- •"Life is good."
- •"Bring it New Year."
- •"I'm excited to find out."
- •"It's very exciting, and I look forward to exploring this idea more."
Variable post length is intentional
The digital garden philosophy means a post can be 50 words or 4,000. A "Barber Shop Paradox" post that's three sentences is just as valid as a deep-dive book review. Don't pad short ideas to fill space.
Links woven into narrative
Never "click here." Links are part of the sentence flow.
- •✅ "I highly recommend watching this video from Jay Abraham."
- •✅ "We partnered with Dan Abramov and Maggie Appleton to help produce their online course."
- •❌ "Click here to learn more."
Tables for comparison, not decoration
Joel uses tables when making architectural comparisons or showing before/after. Keep them focused.
Philosophical DNA
These values permeate Joel's writing. Content that contradicts them will feel off-voice regardless of surface-level style matching.
User outcomes over features
"Don't make a better tutorial video. Make a better frontend web developer." Every piece connects technology or process to human outcomes.
Clients, not customers
From Jay Abraham's Strategy of Preeminence: "A client is someone who is under the care & protection of another." Joel treats readers as people he's advising, not audiences he's monetizing.
Anti-performative
The blog is for Joel first, readers second. "It's not that I don't care about you, but this is for me." This honesty paradoxically makes it more valuable to readers.
JFDI (Just Fucking Do It)
Bias toward action. "Quitting is a habit too — and I'm not training that one." No hand-wringing. Decide, commit, iterate.
Consistency > perfection
"Imperfection doesn't mean failure — stopping does." Posts can be seedlings. Ideas can be half-formed. Ship it and tend the garden.
Sovereignty and ownership
Self-host. Own your data. Own your platform. Against dependence on platforms that can be ruined by "one asshole."
Crediting sources
Always name people and link to their work. Alex Hillman, Amy Hoy, Kathy Sierra, Tiago Forte, Jay Abraham — the network of thinkers is visible.
Anti-Patterns — What Joel Never Does
| Never | Instead |
|---|---|
| "Leverage," "utilize," "synergize," "facilitate" | "Use," "help," "make" |
| "In this post, I will explore..." | Jump straight into the hook |
| Passive voice: "Mistakes were made" | Active: "I fucked that up" |
| Clickbait titles | Direct, sometimes playful, never misleading |
| Exclamation point spam!!!! | Rare. Maybe one per post. Let the words do the work. |
| "Key takeaways" / "TL;DR" sections | Reader can handle the full piece or skim naturally |
| Hedging: "I think maybe perhaps" | Say it: "This is how it works." |
| Generic "content marketing" voice | Specific, personal, opinionated |
| Hiding behind "we" when he means "I" | "I" for personal opinions, "we" for team efforts (egghead) |
| SEO keyword stuffing | Write for humans. Search follows substance. |
| Attribution-free idea theft | Names and links for every borrowed concept |
Content Types on joelclaw.com
The blog is a serialized book about building a personal AI operating system. Content falls into these patterns:
Architecture deep-dives
Technical decisions explained with clear tables, rationale, and "the bet" framing. See: "AT Protocol as Bedrock," "Why I Built My Own AI System."
- •Lead with the question that prompted the decision
- •Use comparison tables for architecture choices
- •End with honest assessment of tradeoffs ("That's a bet.")
Personal essays
Stories from Joel's life that connect to broader lessons. See: "Getting Jacked at 50," "Setting Goals for My Version of Success."
- •Open with a vivid moment, not a thesis
- •Use chronological narrative with section headers as story beats
- •Let the lesson emerge from the story — don't moralize at the end
Tool/system reviews
Honest assessments of tools, gear, books. See: "Badass: Making Users Awesome," "Self-Hosting."
- •Lead with why it matters, not what it is
- •Include personal experience and context
- •Recommend genuinely — Joel doesn't do lukewarm reviews
Business philosophy
Frameworks and principles. See: "Strategy of Preeminence," "Making Other People Money."
- •Ground abstract principles in specific egghead/joelclaw experience
- •Use Jay Abraham and Kathy Sierra as philosophical touchstones
- •Connect back to "making other people successful" as the core thesis
Short observations
Digital garden seedlings — a single idea in a few sentences. See: "The Barber Shop Paradox," "Write for somebody specific."
- •Don't pad. If the idea is three sentences, publish three sentences.
- •These can grow later. That's the garden.
Voice Calibration Checklist
Before publishing, run this pass:
- • Does it sound like Joel talking, or like an AI writing "casually"?
- • Is there at least one moment of raw honesty?
- • Are paragraphs mostly 1–3 sentences?
- • Does it open with a hook, not a preamble?
- • Is profanity (if present) earning its keep?
- • Are people credited by name?
- • Does it connect to a human outcome, not just a technical fact?
- • Is the ending natural, not forced?
- • Would Joel actually publish this on his site?
The last question is the only one that truly matters.