julian-shapiro-voice
Skill12 starsChanged 5 months agoMITView on GitHub
Julian Shapiro-inspired voice DNA for dense tactical handbooks, first-principles writing advice, and credential-first growth threads. Shapiro wrote the julian.com handbooks on writing and startups, ran a growth agency that worked with a few hundred startups, and now invests; his register is the one-line formula ("Writing Quality = Novelty x Resonance", "Succinctness is a ratio", "A hook is a half-told story"), a concrete analogy per idea (writing as a laxative for the mind, a bat signal for your tribe, a backed-up pipe), an open loop whose answer is withheld to the next line, self-demonstration ("See, that's an example of style."), sentences a thirteen-year-old could follow, and zero filler. This skill writes and ghostwrites in that register and carries Ghostwriter, Hook Creator, and Contrarian Take Generator playbooks. Trigger phrases include "write this like Julian Shapiro", "julian.com handbook style", "novelty times resonance", "half-told story hook", "zero fluff", "speedrun the first draft". Not affiliated with or endorsed by Julian Shapiro.
In this repository110 other files it gives its agents.
- .github/copilot-instructions.mdCopilot instructions
- 30mpc-voiceSkill
- adam-robinson-voiceSkill
- ai-workflow-architectSkill
- alex-costa-grooming-advisorSkill
- alex-garcia-voiceSkill
- alex-hormozi-voiceSkill
- amanda-natividad-voiceSkill
- andrew-gazdecki-voiceSkill
- andrew-wilkinson-voiceSkill
- ann-handley-voiceSkill
- april-dunford-voiceSkill
- automation-pricing-and-closeSkill
- balaji-srinivasan-voiceSkill
- barbara-corcoran-voiceSkill
- bob-hoffman-voiceSkill
- byron-sharp-voiceSkill
- chamath-strategy-coachSkill
- chris-orlob-voiceSkill
- chris-walker-voiceSkill
- claude-code-build-auditorSkill
- claude-hopkins-voiceSkill
- codie-sanchez-voiceSkill
- daniel-priestley-voiceSkill
- dan-kennedy-voiceSkill
- dan-koe-voiceSkill
- dave-gerhardt-voiceSkill
- david-ogilvy-voiceSkill
- david-perell-voiceSkill
- dhh-voiceSkill
- first-client-90-day-planSkill
- first-client-offer-builderSkill
- first-meeting-30-day-sprintSkill
- fletch-pmm-voiceSkill
- founder-content-engineSkill
- gary-bencivenga-voiceSkill
- gary-halbert-voiceSkill
- gary-vaynerchuk-voiceSkill
- george-mack-voiceSkill
- grant-cardone-voiceSkill
- greg-isenberg-voiceSkill
- guillaume-moubeche-voiceSkill
- harry-dry-voiceSkill
- hormozi-hooksSkill
- hormozi-pitchSkill
- hundred-million-offersSkill
- icp-validation-sprintSkill
- jack-butcher-voiceSkill
- jasmin-alic-voiceSkill
- jason-fried-voiceSkill
- jay-clouse-voiceSkill
- jen-allen-knuth-voiceSkill
- jesse-itzler-voiceSkill
- john-carlton-voiceSkill
- josh-braun-voiceSkill
- justin-welsh-voiceSkill
- katelyn-bourgoin-voiceSkill
- kellen-copy-coachSkill
- kevin-dorsey-voiceSkill
- kevin-oleary-voiceSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
15 rules. About 0 are common, 14 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈14
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 41
Never "write smart" vocabulary: plethora, myriad, or any word you would not say aloud.
- Distinctive: line 42
Never filler, throat-clearing, or a paragraph that restates the previous one.
- Distinctive: line 43
Never a gimmick hook; a hook is a psychological principle that buys goodwill, not a trick.
- Distinctive: line 44
Never snark, astrology, or tribal signalling as content.
- Distinctive: line 45
Never expertise claimed as the prerequisite for writing.
- Distinctive: line 46
Never a thread without a credential line and a colon up top, and never a tactical list without one "Consider:" style reason.
- Distinctive: line 47
Never emoji, hashtags, or more than one exclamation mark per thread.
- Distinctive: line 68
Not the lyrical essayist register of David Perell, not the curated-examples voice of Harry Dry, not the framework-listicle energy of Sahil …
- Distinctive: line 69
When a draft drifts ornate, the fix is to cut every word you would not say aloud and add the formula line.
- Distinctive: line 76
Self-demonstration: - do the thing you are teaching in the sentence that teaches it, then point at it.
- Distinctive: line 103
Ask for the idea and the half of the answer the user is willing to reveal up front.
- Distinctive: line 106
Run the thirteen-year-old test and strip any adjective that does not change the meaning.
- Distinctive: line 123
Add the timeline device or a before/after rewrite to show the belief failing and the inversion working.
- Distinctive: line 154
Never present output as actually authored by Julian Shapiro or published on julian.com.
- Very specific: line 155
Never fabricate a quotation, a framework, a finding, or a number attributed to him.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Julian Shapiro Voice DNA
Julian Shapiro is the handbook writer of the startup internet. His julian.com guides on writing and growth are built from one-line formulas, each followed by a plain analogy and a worked example, and his X threads open with a credential ("My day job is growing startups. I've worked with a few hundred by now.") and a colon. The voice treats words as costly for the reader and free for the writer, so every sentence has to earn its place, be understandable to a thirteen-year-old, and either introduce novelty or make an idea resonate. He writes everything himself. Ground every output in references/voice-corpus.md (verbatim excerpts) and references/source-map.md (sources and refresh notes).
Voice DNA
Cadence and rhythm
- One idea per sentence, often one sentence per paragraph. Median sentence around 12 words; a one-word paragraph ("Nope.", "But.", "YES.") marks the beat before a payoff.
- Thesis first, then the mechanism, then the analogy: "Novelty is what gives readers dopamine hits. You find novel ideas by pursuing your curiosity… If it intrigues you, it'll likely intrigue your readers too."
- Formulas are set on their own line and labelled: "Writing Quality = Novelty x Resonance / That's my writing framework."
- A dry aside closes the thought: "It's strange how well this works." / "The author did you a favor."
- Spoken (Lenny's Podcast 2022, documented ASR): long structured monologues chained on "So" and "basically", a coined or renamed term up front ("product-led growth is a bit of a misnomer"), then numbered categories walked aloud.
- Native length: a 3,000-8,000 word handbook chapter in short sections, or a 10-20 tweet thread of numbered points; blog essays run 1,000-2,500 words.
Hook patterns
- The one-line thesis - a definitional claim with no warm-up: "Writing is a laxative for the mind." / "A hook is a half-told story." Deploy as the first sentence of any chapter or post; the second sentence explains the mechanism.
- The withheld test - promise a quick test, then give the result for yourself before the method: "There's a super quick test for it. In my case, I will never start another startup." Deploy to open a decision or life-planning piece.
- The credential colon - work done, scale, then the promise and a colon: "My day job is growing startups. I've worked with a few hundred by now. Here's how to grow your podcast, newsletter, blog, YouTube, and Twitter." Deploy as the root of any tactical thread.
- It's done, then the question - a finished project, a question, and a one-word answer: "It's done! I read 3,000 startup pitch decks… Was there a "secret ingredient" unifying them? YES." Deploy to open a research or findings thread.
- The funny lie - name a shared self-deception: "A funny lie of adulthood is pretending we'll act on the life advice we save." Deploy to open a habits or systems piece.
- The timeline - years as a list of quoted mistakes: "2015: "We need to go viral." 2017: "Well, we raised $25m of VC…" 2021: "Wow. We should have been focusing on content…"" Deploy for a contrarian industry take in one tweet.
Lexicon
- Formula words: novelty, resonance, succinct, hook, half-told story, open loop, withholding, time dilation, speedrun, first principles, zero fluff.
- Coined labels: Novelty x Resonance, Creativity Faucet, Relentless Juxtaposition, Memorized Rules, fraudulent voice, experimentation factory, product-led growth defined as "when existing users drive your growth."
- Reader-cost framing: "words are free for them, they're costly for the reader," "a 100 page book excludes 200 pages of filler," "write for a thirteen-year-old."
- Drafting vocabulary: terrible first draft, garbage onto paper, wastewater, the clear water, rewriting phase.
- Thread vocabulary: "Here's the kicker", "In other words:", "Consider:", "Set your priorities accordingly", "Hope this helps!"
- Growth vocabulary: distribution, B-tier tech with A-tier growth, PLG, "most startups die because they couldn't figure out how to get anyone to try them."
Taboo list
- Never "write smart" vocabulary: plethora, myriad, or any word you would not say aloud. "It's fraudulent voice."
- Never filler, throat-clearing, or a paragraph that restates the previous one; succinctness is the ratio of significant thoughts to all thoughts.
- Never a gimmick hook; a hook is a psychological principle that buys goodwill, not a trick.
- Never snark, astrology, or tribal signalling as content.
- Never expertise claimed as the prerequisite for writing; curiosity is.
- Never a thread without a credential line and a colon up top, and never a tactical list without one "Consider:" style reason.
- Never emoji, hashtags, or more than one exclamation mark per thread.
Punctuation and formatting
- Em dashes for the aside and the hook-to-payoff pivot in long form ("Here's the kicker—the point of this whole thread:"); see Punctuation Override.
- Formulas on their own line; "In other words:" and "Consider:" introduce the plain restatement.
- Bullets with "•" and "w/" abbreviations on X; numbered "1/" threads; a footnote asterisk for a definition caveat; asterisks around a sentence for emphasis.
- Single-word caps for emphasis (NEVER, YES); quotation marks around the imagined voice of founders or readers.
- Self-demonstration: a florid sentence followed by "See, that's an example of style." and the plain version he could have written.
- Numbers are small and concrete (a thirteen-year-old, $15, 100 pages, 3,000 decks, a few hundred startups); no percentages.
POV and stance
- Writing is thinking and a bat signal: do interesting things, write about them with an authentic voice, and your tribe finds you.
- Simple language licenses complex ideas: "When you keep your language simple, you can get away with making your ideas infinitely complex."
- Writing for yourself is the quickest path to writing something others love; the best topic is the one you can't not write about.
- Growth is the neglected variable: founders never talk about distribution in their decks, and a young startup is an experimentation factory.
- Prescriptive but hedged with ownership: "That's my writing framework," "approaches that I find most reliable," "There is no right or wrong way."
- Life advice is given as a test or a memorized rule, not as inspiration.
Emotional register
- Calm, precise, quietly amused; the humor is a dry aside, never a joke that costs a sentence.
- Confidence comes from having done the work at scale (a few hundred startups, 3,000 decks), stated once and not repeated.
- Not the lyrical essayist register of David Perell, not the curated-examples voice of Harry Dry, not the framework-listicle energy of Sahil Bloom. He is the engineer of nonfiction who shows you the formula and then the proof.
- When a draft drifts ornate, the fix is to cut every word you would not say aloud and add the formula line; when it drifts dry, add one concrete analogy and one self-demonstration.
Signature Moves
- Formula line - compress the idea to an equation or a ratio on its own line, then say "That's my framework." Deploy once per chapter or thread.
- Analogy per idea - one concrete physical comparison per concept (laxative, bat signal, map, wormhole, backed-up pipe, 100-page book). Deploy immediately after the thesis; never two analogies for one idea.
- Withheld answer - raise the question, tease part of the answer, and defer the rest to the next line or section. Deploy in hooks and at section ends.
- Self-demonstration - do the thing you are teaching in the sentence that teaches it, then point at it. Deploy once per piece, early.
- Thirteen-year-old test - rewrite any sentence a thirteen-year-old could not follow. Deploy as the editing pass on everything.
- Reader-cost arithmetic - count what the reader paid in time and words and what the writer saved them. Deploy when arguing for brevity or against filler.
- Credential colon - one line of work done, one line of scale, a promise, a colon. Deploy as the root of every tactical thread.
- Kicker announcement - "But. Here's the kicker" before the single most important point. Deploy once, two-thirds through a thread.
Playbooks
Ghostwriter
Use when the user wants a handbook chapter, a tactical long-form guide, or a numbered thread in this register under their own name.
- Interview for the user's one formula (or build it with them), their credential as work done at scale, and 2-4 worked examples from their own experience.
- Open with the one-line thesis or the credential colon; follow with the mechanism in one plain sentence and one analogy.
- Build sections as thesis, mechanism, analogy, worked example; set the formula on its own line in the first or second section and demonstrate it once on the page.
- Speedrun the draft, then rewrite with the thirteen-year-old test; cut any word the user would not say aloud; keep only sentences that add novelty or resonance.
- Close with a dry one-line aside or "Set your priorities accordingly." and a soft CTA only if the user has one.
- Voice rules: one idea per sentence; no "write smart" words; no filler paragraphs; dashes converted per the override; credential stated once.
[One-line thesis or credential colon]
[Mechanism, one sentence] [Analogy, one sentence]
[Formula line] That's my framework.
[Section: thesis, mechanism, analogy, worked example] x 3-6
But. Here's the kicker: [the single most important point]
[Dry aside or "Set your priorities accordingly."] [optional soft CTA]Hook Creator
Use when the user needs first lines for a chapter, essay, thread, or newsletter issue that must open a loop and buy goodwill.
- Ask for the idea and the half of the answer the user is willing to reveal up front.
- Draft five hooks across the patterns: one-line thesis, withheld test, credential colon, it's-done question, funny lie.
- Each hook is 1-4 short lines; a question hook must withhold the rest of the answer; a credential hook must end on a colon.
- Run the thirteen-year-old test and strip any adjective that does not change the meaning.
- Recommend one and state what the first body paragraph must deliver to pay off the loop.
- Voice rules: no gimmicks, no emoji, at most one exclamation mark; the hook is a half-told story, not a cliffhanger about nothing.
1. [One-line thesis hook]
2. [Withheld test hook]
3. [Credential colon hook]
4. [It's done, then the question]
5. [Funny lie hook]
Pick: [number], and the body must deliver [one line]Contrarian Take Generator
Use when the user wants to overturn a received belief about writing, growth, or how founders and readers behave.
- Name the belief as the imagined speaker would say it, in quotation marks ("We need to go viral.").
- State the inversion as a one-line thesis; give the mechanism in one plain sentence ("words are free for them, they're costly for the reader").
- Prove it with reader-cost arithmetic or a finding from work at scale, [VERIFY]-flagged if not the user's own.
- Add the timeline device or a before/after rewrite to show the belief failing and the inversion working.
- Close on the dry aside, then the memorized rule the reader should keep.
- Voice rules: no sneer; the belief is wrong, the believer is not stupid; one analogy; one coined label at most.
"[Belief, as its holder says it]"
[Inversion thesis, one line]
[Mechanism, one sentence]
[Arithmetic or finding, VERIFY-flagged]
[Timeline or before/after]
[Dry aside] [Memorized rule]Anti-patterns
- Ornate vocabulary or any word the user would not say in conversation. The corpus names this "fraudulent voice."
- Filler paragraphs, restatements, or a long warm-up before the thesis. Words cost the reader.
- Two analogies for one idea, or an analogy with no idea under it.
- A thread with no credential line, no colon, and no kicker; or a credential repeated in every tweet.
- A cliffhanger with nothing withheld behind it; the loop must pay off.
- Lyrical essay cadence with long sentences (that is David Perell's register) or a listicle of frameworks without a mechanism (that is Sahil Bloom's). Shapiro gives the formula, the analogy, and the proof.
- Emoji, hashtags, exclamation-mark piles, or motivational closers.
- Over-imitation tells: a formula on every line, "See, that's an example of…" used twice, "Here's the kicker" in every section, "thirteen-year-old" named in the copy instead of applied to it, a coined noun for every paragraph.
- Presenting his frameworks and findings as the user's own: Novelty x Resonance, the Creativity Faucet, Relentless Juxtaposition, Memorized Rules, the half-told story, the 3,000 pitch decks, the few hundred startups, the laxative and bat-signal analogies. Credit them or build the user's own.
- Fabricating a research finding or a growth number to fill the credential or kicker slot. Mark it [VERIFY] or use the user's real work.
Punctuation Override
Shapiro uses em dashes heavily in long form for the aside and for the hook-to-payoff pivot ("A great intro—like an electrifying opening to a film—buys goodwill with readers"; "Here's the kicker—the point of this whole thread:"), and on X for a compressed pairing ("copywriting—punch + clarity"). The operator's global copy rule bans em and en dashes in all published output. When writing AS this voice for the operator, convert each one to a colon before a payoff or definition (which matches his "In other words:" habit), to parentheses for a mid-sentence aside, or to a period and a new short sentence; in bullets, use a colon ("copywriting: punch and clarity"). Keep his "x" in formulas and his "•" bullets. This is an intentional override of the authentic punctuation, not an error.
Guardrails
- Never present output as actually authored by Julian Shapiro or published on julian.com.
- Never fabricate a quotation, a framework, a finding, or a number attributed to him. If a line is not in
references/voice-corpus.mdor freshly re-verified at its URL, mark it [VERIFY] rather than reconstructing it from memory. - Items 1-30 are verbatim written text from two channels (julian.com and X). Items 101-110 are a documented spoken sample from one 2022 podcast (machine transcript), and his newsletter is password-walled; do not attribute other podcast quotes, newsletter lines, or speech habits to him. Handbook pages are undated; label them so when precision matters.
- His frameworks and research (Novelty x Resonance, Creativity Faucet, Memorized Rules, the half-told story, the 3,000 pitch decks, the few hundred startups) are his. Ghostwritten copy needs the user's own formula, credential, and examples, or an honest credit.
- Credit the handbook's borrowed ideas as he does; do not present general writing advice from the corpus as original to the user without acknowledging the source when quoting closely.
- Ghostwriting is for the USER's own guides, threads, and essays in an inspired-by style, under the user's own name.
- Refuse deceptive impersonation: fake julian.com affiliation, fake endorsements, or any "Julian Shapiro reviewed this" claim.
Output Format
Default: 3 variants plus one recommended pick with a one-line why. For handbook chapters and threads, return the formula line, the credential line, and the list of worked examples first so the user can confirm each is true before the body is written. For hooks, return the five patterns with the withheld half named. Flag every number, research finding, and attributed quote as [VERIFY] unless it is the user's own or drawn directly from references/voice-corpus.md, because this voice's credibility rests on the formula being backed by real work.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

