.claude/skills/thought-leadership/SKILL.md
Creates value-packed, niche-specific, thought leadership newsletters (800-1,500 words) with irresistible subject lines, skimmable headers, and actionable content. Uses proven frameworks for headlines, introductions, and sectioning. Use when user mentions "write newsletter", "thought leadership content", "weekly newsletter", or wants to create educational, value-driven newsletter content.
npx skillsauth add navotvolkgroundup/nabot thought-leadershipInstall 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.
Purpose: Write value-packed thought leadership newsletters (800-1,500 words) that educate, entertain, and position the writer as the go-to authority in their space.
Use this skill when:
This is NOT generic content. This is NOT AI slop. This is:
Target Length: 800-1,500 words (enough to go deep, short enough to respect attention)
Every newsletter that converts has four components working together:
| Pillar | Job | |--------|-----| | Subject Line | Get the open. Everything else is worthless if they don't click. | | Introduction | Hook them in 3 seconds, make a promise they can't ignore | | Headers | Deliver standalone value—readers should learn just by scrolling | | Section Content | Tactical, specific, "I can use this today" insights |
Before writing a single word, load all context profiles from /context/:
voice.json — How the user actually sounds (not how AI thinks they should sound)audience.json — The specific human they're writing forbusiness-*.json (or relevant business profile) — What they offer and why it mattersThese aren't optional. Skip them and you're writing for nobody.
Generate 5 subject line variations using this proven structure:
The anatomy of a subject line that gets clicked:
| Component | What It Does | Example | |-----------|--------------|---------| | Number | Creates specificity, signals clear value | 3, 5, 7 (odd numbers work best) | | Topic | What you're teaching | "prompts", "newsletter systems", "AI workflows" | | Approach | The lens you're using | Tips, Steps, Mistakes, Lessons, Reasons, Secrets | | Audience | Who this is for (optional but powerful) | "for solopreneurs", "every creator needs" | | Outcome | The tangible result they want | "write newsletters in 30 minutes" | | Bonus Outcome | The cherry on top (optional) | "without burning out" |
Formula in action:
[Number] + [approach] + [topic] + [outcome] + [bonus outcome]
Examples that work:
Subject Line Rules:
| Rule | Why It Matters | |------|----------------| | 30-50 characters ideal | Shows fully on mobile, creates urgency | | 60 characters max | Gets cut off after this | | Sentence-case only | "5 ways to build your system" not "5 Ways To Build Your System" | | If starts with number | Don't capitalize the next word |
The Outcome Test:
Every subject line must pass this test—is the outcome tangible?
| Type | Example | Verdict | |------|---------|---------| | ❌ Vague | "So you can be more productive" | Means nothing | | ❌ Generic | "To improve your writing" | Says nothing specific | | ✅ Tangible | "So you can publish daily without burning out" | Clear, measurable, desirable | | ✅ Specific | "To cut your writing time from 4 hours to 45 minutes" | Exact numbers, real result |
The introduction has ONE job: make them keep reading.
The 5-Part Introduction Framework:
Simple. Human. Warm.
Don't overthink this. It's a handshake, not a speech.
You have 3 seconds. Choose your weapon:
| Hook Type | Example | When to Use | |-----------|---------|-------------| | Thought-provoking question | "What if everything you know about prompting is wrong?" | When challenging assumptions | | Bold declarative statement | "AI writing doesn't have to sound like AI." | When making a strong claim | | Specific moment/realization | "Last Tuesday I deleted 47 prompts. Here's why." | When you have a story | | Vulnerable admission | "I wasted 6 months prompting the wrong way." | When building trust through honesty | | Contrarian take | "Prompt engineering is dead. Context engineering is the future." | When going against conventional wisdom | | Surprising stat/insight | "I spent 4 hours on every newsletter. Now it takes 35 minutes." | When you have compelling numbers |
The hook should create an open loop—a question in the reader's mind that demands an answer.
Now expand. You have two angles:
Angle A: Lead with the problem
Angle B: Lead with the outcome
Example (Problem-first):
Most people using AI for writing are doing it backwards.
They open Claude. They prompt. They get generic slop. They try to fix it. They get frustrated. They give up and write manually anyway.
The problem isn't AI. It's not your prompts either.
It's that you're missing the layer that makes AI actually useful: context.
Example (Outcome-first):
Imagine opening Claude and getting a first draft that sounds like you wrote it.
Not "AI-sounding." Not generic. Actually you.
That's not a fantasy. That's what happens when you build the right system.
State exactly what you're giving them. Be specific.
| ❌ Vague | ✅ Specific | |----------|-------------| | "I'll show you how to improve" | "Today I'm breaking down the 3 context files that make AI write like you" | | "Here's what I've learned" | "Here are the 5 prompts I use every single day" |
Bridge to the content. Short and punchy.
The 80% Rule: A reader who only scans your headers should walk away with 80% of the value.
Headers aren't labels. They're mini-insights.
Ways to Structure Your Content:
| Structure | Best For | Example Headers | |-----------|----------|-----------------| | Tips | Tactical advice | "Tip 3: Use JSON for context profiles, not paragraphs." | | Steps | Sequential processes | "Step 2: Build your voice profile." | | Mistakes | What to avoid | "Mistake 1: Prompting without context." | | Lessons | Hard-won insights | "Lesson 4: AI can't read your mind (yet)." | | Reasons | Making a case | "Reason 2: Context compounds. Prompts don't." | | Examples | Showing possibilities | "Example 3: How I repurpose one video into 12 posts." | | Questions | Addressing objections | "Won't this take forever to set up?" | | Myths | Busting misconceptions | "Myth: You need to be technical to use Claude Code." | | Principles | Foundational truths | "Principle 1: AI is your co-writer, not your ghostwriter." | | Frameworks | Mental models | "Framework: The Context Triangle." |
Header Format Rules:
Header Examples:
| ❌ Weak (Label) | ✅ Strong (Insight) | |-----------------|---------------------| | "Why context matters" | "Context turns generic AI into your voice." | | "The importance of structure" | "Structure lets you write once and use forever." | | "About prompting" | "Prompting without context is like cooking without ingredients." |
Number of Sections:
| Sections | Approach | |----------|----------| | 7-10 sections | Headers carry most weight, sections stay brief (1-3 paragraphs) | | 3-5 sections | Go deeper in each section (3-6 paragraphs), more room to breathe |
Choose based on the topic. Tactical content = more sections. Conceptual content = fewer, deeper sections.
Each section follows a rhythm:
[Single-sentence opener that sets up the point]
[2-4 sentences of explanation, context, or story]
[Optional: bullets for examples, options, or lists — max ONE bullet section per header]
[Single-sentence closer that lands the point or transitions]
The Content Principles:
| Principle | What It Means | Example | |-----------|---------------|---------| | Specific over general | Real examples, actual numbers, concrete details | "This cut my writing time from 4 hours to 35 minutes" not "This saved me lots of time" | | Actionable | Reader knows exactly what to DO | "Create a file called voice.json in your context folder" | | No fluff | Every sentence earns its place | If you can delete a sentence and lose nothing, delete it | | Skimmable | Easy to scan and extract value | Short paragraphs, white space, clear structure |
Example Section (Well-Written):
### Context turns generic AI into your voice.
Before you prompt anything, Claude needs to know who you are.
Not your name. Your voice. How you write. What you never say. The phrases you overuse. The rhythm of your sentences. The way you open a newsletter versus close one.
I call this your voice profile. It's a structured profile that captures:
- Your tone and personality
- Your sentence patterns and rhythms
- Your signature phrases
- Your boundaries (what you never sound like)
Without this, every prompt starts from zero. With it, Claude writes like you from the first draft.
That's the difference between AI that helps and AI that wastes your time.
What makes this work:
Your newsletter lives in an inbox, not a blog. Format accordingly.
Formatting Rules:
| Element | Rule | |---------|------| | Headers | Bold, ### format, full sentences | | Paragraphs | Short. 1-3 sentences max. One idea per paragraph. | | Bullets | For lists, examples, options. Keep tight. | | White space | Generous. Let it breathe. Line breaks between sections. | | Links | Include where relevant. Don't overdo it. | | Bold | Use for emphasis. Sparingly. | | ALL CAPS | Almost never. Maybe ONE word for emphasis. |
The Scroll Test:
Before you finish, scroll through quickly. Ask:
When delivering a newsletter, use this structure:
## Subject Line Options
1. [Option 1 - sentence-case]
2. [Option 2 - sentence-case]
3. [Option 3 - sentence-case]
4. [Option 4 - sentence-case]
5. [Option 5 - sentence-case]
**Recommended**: Option [X] — [Why this one works best]
---
## Newsletter Draft
**Word count**: ~[X] words
---
Hey there!
[Opening hook — 1 sentence that stops the scroll]
[Promise — 3-7 sentences on the problem or outcome]
[Solution — 1-2 sentences on what you're delivering today]
[Transition — 1 sentence]
### [Header 1: Full sentence that delivers value.]
[Single sentence opener]
[2-4 sentences of explanation/context]
[Optional bullets if needed]
[Single sentence closer]
### [Header 2: Full sentence that delivers value.]
[Continue the rhythm...]
### [Header 3: Full sentence that delivers value.]
[Continue...]
[Closing line — optional CTA or sign-off]
---
**Stats**: [X] words | [X] sections | [X] minutes read
Before delivering, verify:
| ❌ Don't | ✅ Do | |----------|-------| | "Why context matters" | "Context turns generic AI into your voice." | | "The importance of skills" | "Skills let you write instructions once and use them forever." | | "Understanding AI writing" | "AI writing fails when you skip the context layer." |
Fix: Turn every header into a complete insight. If it's not a takeaway, rewrite it.
| ❌ Don't | ✅ Do | |----------|-------| | "Be consistent with your content" | "Publish every Tuesday at 9am. Your audience will expect it." | | "Build a system" | "Set up your context files in the context folder." | | "Use AI effectively" | "Give Claude your last 10 newsletters before asking it to write a new one." |
Fix: Replace every general statement with a specific action, number, or example.
| ❌ Don't | ✅ Do | |----------|-------| | "This saved me a lot of time" | "This cut my newsletter writing from 4 hours to 35 minutes." | | "My audience grew" | "I went from 500 to 3,400 subscribers in 6 months." | | "It works really well" | "My open rates jumped from 32% to 51%." |
Fix: Add numbers. Add timeframes. Add before/after. Add proof.
The newsletter should sound like a person, not a textbook.
Ways to add personality:
Fix: After writing, read it out loud. If it sounds like a robot, rewrite the flat parts.
Information is free. Everywhere. Anyone can Google "how to use AI for writing."
What they can't Google:
Thought leadership isn't about knowing more. It's about having a clearer lens.
| Goal | How You Achieve It | |------|-------------------| | Deliver real value | Reader learns something useful they can apply today | | Establish authority | You clearly know what you're talking about (specifics, experience, depth) | | Sound like the writer | Not generic, not AI-sounding, unmistakably them |
When someone finishes your newsletter, they should think:
If they think "that was fine" — you've failed. Fine doesn't get forwarded. Fine doesn't build authority.
Write newsletters that are impossible to ignore.
business
Generate tweets that match the voice profile and resonate with your target audience. Tweets should feel like authentic observations from an experienced insider, not marketing content.
data-ai
# X Reply Generator for @nabotweet ## Overview Generate replies to people who respond to your tweets. Replies should sound natural, match your voice, and add value to the conversation. ## Before Writing 1. **Read context profiles** in `/context/`: - `voice.json` — How to sound - `audience.json` — Who you're talking to - `business-groundup.json` — GroundUp Ventures context - `business-weeklysync.json` — Weekly Sync podcast context 2. **Read replies data** from `/knowledge/engagem
business
Generate LinkedIn posts that match the voice profile and resonate with your target audience. Posts should feel like real thinking from someone in the arena - not thought leadership content marketing.
testing
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.