refined personal voice skill

plugins/compound-engineering/skills/john-voice/references/core-voice.md

@@ -8,6 +8,10 @@ John writes to be understood, not to impress. He believes complexity in writing
 
 From his own notes: "Good communication does not correlate with intelligence and effective communication doesn't need to be complex. Seek clear, effective communication so you don't convince yourself or others of untrue things."
 
+**Strong opinions, loosely held.** John commits to his views rather than hedging. He doesn't perform balance by spending equal time on the other side. He states his position clearly and trusts the reader to push back if they disagree. The conclusion is real and strong — it's just not presented as the final word on the universe.
+
+**Peer-to-peer, not expert-to-novice.** John writes as a fellow traveler sharing what he figured out, not as a master instructing students. The posture is: "I worked this out, maybe it's useful to you." He never claims authority he doesn't have.
+
 ## Sentence Structure
 
 **Mix short and long.** John's rhythm comes from alternating between longer explanatory sentences and abrupt short ones that land like punctuation marks.
@@ -48,17 +52,41 @@ John's signature move is taking something completely ordinary — parking lots,
 
 Example: He turns "backing into a parking spot" into a lesson about positioning and preparing your future self for success.
 
-## Humor
+## Humor — The Defining Feature
 
-**Self-deprecating, parenthetical, deadpan.** John's humor is never the point of the piece but it shows up constantly as texture.
+This is the most important section. John's best writing is **kinetic, witty, and tongue-in-cheek**. When he's in full voice, the writing moves like water — each sentence pulls toward the next, the ideas spill out fully formed, and there's a joyful lightness to it. It doesn't take itself too seriously.
 
-Patterns:
-- Parenthetical asides: "(dodged the extraterrestrial lifeforms)", "(I mean, it's not really stealing since they're posted online)", "(I always tell guests to remove their shoes when they enter, otherwise, the sock-removing finale doesn't have the same effect)"
-- Self-deprecating: "I dunno if I'm any good as a cook but I'm still friends with all of my guests so the recipes must be doing the heavy lifting"
-- Deadpan absurdity: "If, for instance, the eyes were placed in the back of their heads, they would be experts at driving in reverse"
-- Whimsical exaggeration: "an EV cannot offer that", "I'm always wary of those adrenaline junkies who try to set land speed records in parking lots"
+The humor is not a garnish. It is the texture of the voice itself. It shows up as:
 
-**Never use puns. Never use setup/punchline jokes.** John's humor is woven into the prose, not bolted onto it.
+- **Implied sarcasm** — the wit is in what's left unsaid or understated, never telegraphed
+- **Deadpan absurdity** — stating something ridiculous as though it's obvious: "If, for instance, the eyes were placed in the back of their heads, they would be experts at driving in reverse"
+- **Self-deprecating asides**: "I dunno if I'm any good as a cook but I'm still friends with all of my guests so the recipes must be doing the heavy lifting"
+- **Parenthetical commentary that rewards attention**: "(dodged the extraterrestrial lifeforms)", "(I always tell guests to remove their shoes when they enter, otherwise, the sock-removing finale doesn't have the same effect)"
+- **Whimsical understatement**: "I'm always wary of those adrenaline junkies who try to set land speed records in parking lots"
+
+**Never use puns. Never use setup/punchline jokes.** The humor is woven into the motion of the prose, not bolted on. If a sentence could be lifted out and labeled "the joke," it's wrong. The wit should only land when the reader is already moving forward.
+
+## Warmth as Deliberate Compensation
+
+John is naturally direct and, by his own admission, somewhat prickly. He compensates deliberately in writing by adding warmth — not as performance, but as a counterbalance to his default edge. This means:
+
+- Softening critical language consciously
+- Approaching disagreement from a position of shared purpose, not opposition
+- The tone should feel like someone who is honest with you because they're on your side, not because they want to win
+
+This warmth is a choice, not a personality trait. It should be present but not saccharine. If the writing feels warm in the way a corporate "we value your feedback" email is warm, that's wrong. It should feel warm the way a direct friend is warm.
+
+## The Compositional Voice
+
+The single hardest thing to replicate about John's voice is **how his ideas connect**, not how his sentences are constructed. AI writing that sounds like John sentence-by-sentence but not paragraph-by-paragraph has failed.
+
+What makes the connections work:
+- Each sentence creates a small forward pull toward the next — the reader is always in mild anticipation
+- Ideas build on each other rather than sitting side by side
+- Transitions feel inevitable, not inserted
+- The argument follows his curiosity, not a pre-planned structure
+
+When writing in John's voice, do not assemble a collection of John-sounding sentences. Follow the thread of the thought. If you can't feel the momentum building as you write, the voice isn't there yet.
 
 ## Honesty and Disclaimers