skills/by-role/marketing/thought-leadership-writer/SKILL.md
Write long-form thought leadership articles, opinion pieces, industry POV essays, and CEO/founder bylines using the Made to Stick SUCCESs framework (Chip and Dan Heath). Use when the user asks for a long-form article, executive byline, opinion piece, industry POV, manifesto, "explain our point of view on X", or wants to publish an authority-building piece (1200-2500 words). Reads brand voice and positioning from knowledge/.
npx skillsauth add qa-aman/claude-skills thought-leadership-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Writes long-form opinion pieces that establish authority and get shared. Uses the Made to Stick SUCCESs framework (Chip & Dan Heath, Made to Stick) to ensure every piece is memorable, not just well-written.
The core insight from Made to Stick: Ideas fail to stick not because they're wrong, but because they're abstract, predictable, and forgettable. The SUCCESs framework systematically fixes this. A thought leadership piece that checks all 6 conditions will be remembered, quoted, and shared. One that checks none will be read once and forgotten.
Apply all 6 conditions to every piece. Each one is a checklist item, not optional.
| Letter | Condition | The test | How to apply | |---|---|---|---| | S | Simple | Can you express the core idea in one sentence? | Find the lead - the single most important insight. Strip everything that doesn't serve it. | | U | Unexpected | Does the piece break a pattern the reader expected? | Open by violating an assumption. Say the thing the reader didn't see coming. | | C | Concrete | Are there specific people, places, objects, and numbers? | Replace abstract claims with tangible examples. "Activation rate stuck at 52%" not "low engagement". | | C | Credible | Why should anyone believe this? | Use statistics, named examples, or an "anti-authority" (a customer or peer, not just the brand). | | E | Emotional | Does the reader care? | Tap the "self-interest" trigger (this affects you) or the "identity" trigger (this is about who you are). | | S | Stories | Is there a narrative? | Use a story - even a short one - to make the idea travel. People remember stories, not arguments. |
Read knowledge/brand/voice.md, knowledge/markets/positioning.md, knowledge/markets/competitors.md. Stop if voice is missing: "Run /onboard --brand first."
A weak thesis kills everything downstream. Before writing, run it through three tests:
Test 1 - Specificity. Can it be argued with?
Test 2 - Contestability. Would a reasonable person disagree?
Test 3 - Alignment. Does it reinforce knowledge/markets/positioning.md?
If the thesis fails any test, propose 2-3 sharper versions before proceeding.
Complete this before writing:
SUCCESs pre-write for: [Working title]
S - SIMPLE (the core)
One-sentence core idea (not the title - the insight):
What gets cut if we had to strip 50% of the piece:
U - UNEXPECTED (the pattern break)
What does the reader expect to hear on this topic?
What's the unexpected angle or opening move?
First sentence candidate (the pattern-breaker):
C - CONCRETE (the specifics)
3 specific examples, numbers, or named cases to use:
1.
2.
3.
Any abstract claims that need a concrete replacement?
C - CREDIBLE (the proof)
Primary credibility source (stat, study, customer, or self-experience):
Anti-authority candidate (a peer, customer, or skeptic who validates the point):
What the reader might object to, and the counter:
E - EMOTIONAL (why they should care)
Self-interest angle: how does this affect the reader directly?
Identity angle: what does believing this say about who they are?
The "curse of knowledge" check: are we assuming context the reader doesn't have?
S - STORIES (the narrative)
Opening story candidate (specific scene, not a parable):
Supporting anecdote (from knowledge/content-library/ or user input):
The moment of realization (the turn in the narrative):
Use this structure. Each section maps to SUCCESs elements.
## 1. Hook (150-200 words) [U + S + stories]
Open with the UNEXPECTED move. Options:
- A specific scene ("Last Tuesday, a Head of Growth showed me her dashboard...")
- A counterintuitive stat ("The average B2B trial has 11 onboarding steps. The best ones have 4.")
- A direct challenge to conventional wisdom ("Most companies are measuring the wrong metric.")
Rule: The thesis should appear by the end of the hook, or at the start of section 2.
Never open with "In today's..." / "As we all know..." / "It's no secret that..."
## 2. What everyone believes (200-300 words) [Credible]
Steelman the conventional wisdom. Be generous. Don't strawman.
- "The standard advice is X, and it's not wrong. It's just incomplete."
- Name real examples of the conventional approach being applied
## 3. Why it's wrong (or incomplete) (300-500 words) [Unexpected + Concrete + Credible]
The UNEXPECTED argument. Specific evidence.
- Name the cracks in the conventional approach
- Use concrete examples (named companies, specific numbers, real situations)
- "We've seen this in [X] clients. The pattern is..."
- The anti-authority: quote a peer, customer, or skeptic - not just the brand
## 4. The new model (400-600 words) [Simple + Concrete + Emotional]
The author's POV. This is where the SIMPLE core lives.
- Define new terms if needed (give the idea a name it can travel with)
- Show how the new model works with a CONCRETE example
- Tap EMOTIONAL: "Here's why this matters for you specifically"
- Include a framework, visual, or 3-part structure the reader can remember and repeat
## 5. What to do about it (200-400 words) [Concrete + Emotional + Stories]
Practical application. Not abstract implications.
- 3 specific actions the reader can take
- At least one they can take today or this week
- One supporting story from knowledge/content-library/ if available
## 6. Close (100-150 words) [Simple + Unexpected]
The quotable line. One sentence the reader will screenshot.
- Restate the core insight in its sharpest form
- Call to something: a belief, an action, a question
- The ending should feel inevitable in hindsight, not obvious from the start
Apply voice from knowledge/brand/voice.md. Rules:
S - Simple: [ ] Core idea expressible in one sentence
[ ] No paragraphs that don't serve the core idea
U - Unexpected: [ ] Opening breaks a pattern or assumption
[ ] Reader encounters at least 1 "I didn't expect that" moment
C - Concrete: [ ] At least 3 specific examples (named company, number, or scene)
[ ] No abstract claim left without a concrete anchor
C - Credible: [ ] Primary credibility source present (stat, case study, or experience)
[ ] At least 1 "anti-authority" (peer/customer validates, not just the brand)
E - Emotional: [ ] Piece taps self-interest ("this affects you") or identity ("this is about who you are")
[ ] No "curse of knowledge" - doesn't assume context reader doesn't have
S - Stories: [ ] At least 1 narrative (specific scene with a beginning, middle, and turn)
[ ] Close has a line worth quoting or sharing
Voice checks:
[ ] Thesis appears before word 300
[ ] Voice matches knowledge/brand/voice.md
[ ] No em dashes, no filler openers, no buzzwords
output/thought-leadership/<DD-MM-YYYY>-<slug>.md with frontmatter:
---
format: thought-leadership
framework: made-to-stick-success
thesis: <one-sentence claim>
author: <name or role>
target: <publication>
words: <count>
success-score: S/U/C/C/E/S checked
created: DD-MM-YYYY
---
/linkedin-post)| Most common failures | Fix | |---|---| | Piece is technically accurate but boring | Missing U (unexpected) and S (stories) | | Piece makes big claims nobody believes | Missing C (credible) | | Piece is smart but nobody shares it | Missing E (emotional) - reader doesn't see why it matters to them | | Piece is interesting but hard to remember | Missing S (simple) - no single core idea | | Piece is full of jargon and abstractions | Missing C (concrete) - no specific examples |
development
Plan a webinar end-to-end using April Dunford's Obviously Awesome positioning framework to find the topic angle that makes the webinar obviously valuable to the right audience. Produces topic positioning, abstract, speaker brief, registration page, promotion sequence, day-of run-of-show, and post-webinar follow-up. Use when the user asks to plan a webinar, virtual event, online workshop, "we need a webinar on X", host a webinar, online masterclass, or any live virtual event with promotion and follow-up. Reads ICP, services, and brand voice from knowledge/.
development
Plan a monthly content calendar across channels using the Content Marketing Matrix (Dave Chaffey, Smart Insights) - Entertain/Inspire/Educate/Convince. Every post gets a quadrant label. The monthly calendar must hit 40% Educate, 40% Inspire+Convince, 20% Entertain. Produces a week-by-week posting schedule with topics, formats, channels, and asset links. Use when the user says "content calendar", "social calendar", "plan next month's content", "what should we post", "content plan", "editorial calendar", "schedule posts for the month", or wants a structured posting plan for LinkedIn, Twitter, email, or blog. Reads brand voice, ICP, and past learnings from knowledge/.
development
Write SEO-optimized long-form articles targeting specific keywords using the They Ask You Answer Big 5 framework (Marcus Sheridan). Articles are categorized by Big 5 type (Cost, Problems, Versus, Best/Reviews, How-To) and structured accordingly. The "answer first" rule applies to every article. Use when the user asks for an SEO article, blog post for ranking, "rank for keyword X", organic content, search-optimized post, pillar page, or content for organic traffic. Includes keyword targeting, search intent matching, internal linking suggestions, and meta tags.
data-ai
Capture learnings from a campaign, launch, sprint, or initiative using Five Whys (Taiichi Ohno, Toyota Production System) for root cause analysis and Start-Stop-Continue for action planning. Append reusable insights to knowledge/learnings.md so future runs of the OS get smarter. Use when the user asks for a retro, retrospective, post-mortem, "what did we learn", "campaign wrap-up", "lessons learned", or after a campaign or launch ends. Critical feedback loop that makes the OS compound over time.