Skip to main content
skill CX Codex

viral-hook-creator — Claude Code skill: viral social hooks

Generates 3–5 attention-grabbing opening lines for posts, threads and videos using proven psychological patterns.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ognjengt/founder-skills --skill viral-hook-creator -a claude-code
Open on GitHub

What viral-hook-creator does

The skill writes hooks for X/Twitter, LinkedIn, Instagram and TikTok. Two reference files sit behind it: 18 hook patterns with psychology notes and a selection matrix that maps goal and platform, plus four categories of trigger words — Insider, Helper, Thinker and Amplifiers. The agent has to read both files before generating anything, then picks patterns, drops one or two trigger words into each hook and runs a self-check.

If FOUNDER_CONTEXT.md exists in the project root, the skill pulls industry terms, audience pain points and brand voice from it. Without that file it falls back to defaults: three hooks, X/Twitter, engagement as the goal, a general founder audience. Character limits are hard-coded too — 120 for X/Twitter, 40–60 for the LinkedIn first line, 20–30 for TikTok on-screen text.

One thing to know before you install: the skill returns opening lines only, not finished posts. You still write the rest. And without FOUNDER_CONTEXT.md the hooks come out generic, so prepare that file first if the project has a specific voice.

What it helps with

  • write a scroll-stopping first line for an X post
  • come up with an opener for a TikTok video
  • generate 3–5 distinct hook options for one piece of content
  • match a hook pattern to a specific goal and platform
  • work trigger words into a draft headline

Example prompts for the agent

  • Write hooks for a post about our SaaS launch, platform X
  • Give me 5 first-line options for a LinkedIn post about startup hiring
  • Create a hook for a TikTok video about freelancer mistakes

How to install viral-hook-creator

1Skills CLI (Vercel)

npx skills add ognjengt/founder-skills --skill viral-hook-creator -a claude-code

2Manually: put the files in place

~/.claude/skills/viral-hook-creator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/viral-hook-creator/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about viral-hook-creator

How do I install viral-hook-creator in Claude?

Run npx skills add ognjengt/founder-skills --skill viral-hook-creator -a claude-code. The skill lands at ~/.claude/skills/viral-hook-creator/SKILL.md.

What does viral-hook-creator do?

It generates 3–5 hook options using 18 proven patterns and four categories of trigger words. Each hook uses a different pattern so the options don't repeat each other.

What does the skill need to run?

It reads ./references/hook-patterns.md and ./references/trigger_words.md before generating — without them it won't proceed. A FOUNDER_CONTEXT.md file in the project root is optional, but it lets the hooks use your business specifics.

Source text

SKILL.md · MIT
---
name: viral-hook-creator
description: Creates viral social media hooks using proven psychological patterns and trigger words. Use when user needs attention-grabbing openings for posts, threads, videos, or content.
---

# Viral Hook Creator

## Purpose
Generate 3-5 viral hook options using proven psychological patterns that create curiosity, provide value, and drive engagement. Hooks are optimized for social platforms (X/Twitter, LinkedIn, Instagram, TikTok).

---

## Execution Logic

**Check $ARGUMENTS first to determine execution mode:**

### If $ARGUMENTS is empty or not provided:
Respond with:
"viral-hook-creator loaded, proceed with additional instructions"

Then wait for the user to provide their requirements in the next message.

### If $ARGUMENTS contains content:
Proceed immediately to Task Execution (skip the "loaded" message).

---

## Task Execution

When user requirements are available (either from initial $ARGUMENTS or follow-up message):

### 1. MANDATORY: Read Reference Files FIRST
**BLOCKING REQUIREMENT - DO NOT SKIP THIS STEP**

Before doing ANYTHING else, you MUST use the Read tool to read BOTH reference files. This is non-negotiable:

```
Read: ./references/hook-patterns.md
Read: ./references/trigger_words.md
```

**What you will find:**
- **hook-patterns.md**: 18 proven hook patterns with templates, psychology explanations, and the Pattern Selection Matrix
- **trigger_words.md**: Four categories of viral trigger words (Insider, Helper, Thinker, Amplifiers)

**DO NOT PROCEED** to step 2 until you have read both files and have the patterns and trigger words loaded in context.

### 2. Check for Business Context (Optional)
Check if `FOUNDER_CONTEXT.md` exists in the project root.
- **If it exists:** Read it and use the business context to personalize your output (industry terminology, audience pain points, brand voice, authority metrics).
- **If it doesn't exist:** Proceed using defaults from the "Defaults & Assumptions" section.

### 3. Analyze Input
From the user's requirements, extract:
- Content topic/theme
- Target platform (X, LinkedIn, Instagram, TikTok, general)
- Goal (awareness, education, engagement, conversion)
- Target audience demographics and psychographics
- Available social proof (stats, achievements, research)

For any missing information, apply defaults from the **"Defaults & Assumptions"** section.

### 4. Generate Viral Hooks
Using the patterns and trigger words you read in Step 1, create hooks:

1. **Select patterns** from hook-patterns.md using the Pattern Selection Matrix (match user's goal + platform)
2. **Draft each hook** using the pattern template as your starting point
3. **Integrate 1-2 trigger words** from trigger_words.md into each hook as you write:
   - **Insider words** (secretly, revealed, hidden, uncovered, etc.) → exclusivity patterns
   - **Helper words** (losing, wasting, bleeding, stealing, etc.) → problem/urgency patterns
   - **Thinker words** (backwards, myth, counterintuitive, paradox, etc.) → contrarian patterns
   - **Amplifiers** (literally, every, zero, completely, etc.) → any pattern for intensity

4. **Follow all Writing Rules** (Core Rules, Pattern-Specific Rules, Platform-Specific Adaptations)
5. **Ensure differentiation** - each hook must use a unique pattern
6. **Verify natural integration** - trigger words should enhance, not distract

### 5. Format and Verify
- Structure output according to **Output Format** section
- Complete **Quality Checklist** self-verification
- Verify each hook contains trigger words from the reference file

---

## Writing Rules
Hard constraints. No interpretation.

### Core Rules
- Maximum 120 characters for X/Twitter hooks.
- Maximum 1-2 lines (40-60 characters) for video hooks.
- Lead with the most interesting element.
- Create a curiosity gap (promise value but withhold details).
- Use specific numbers when possible (not "many" but "17").
- Avoid clickbait that doesn't deliver.
- Use power words: steal, secret, mistake, never, proven, blueprint.
- No emojis unless platform-specific (Instagram/TikTok OK, LinkedIn/X avoid).
- No fluff or filler words.
- Active voice only.
- Present tense preferred.

### Pattern-Specific Rules
- For authority hooks: Lead with credible metric.
- For list hooks: Use odd numbers (7 > 6, 5 > 4).
- For story hooks: Start with unexpected outcome.
- For data hooks: Lead with surprising stat.
- For cautionary hooks: Lead with mistake/lesson.

### Platform-Specific Adaptations
- **X/Twitter**: Punchy, contrarian, data-driven, 120 char max.
- **LinkedIn**: Professional, achievement-oriented, thought leadership, 40-60 char first line.
- **Instagram**: Visual promise, lifestyle-oriented, aspirational, 125 char before "more" cutoff.
- **TikTok**: Fast-paced, relatable, trend-aware, 20-30 char on-screen text.
- **General**: Versatile, platform-agnostic.

---

## Output Format
Clean and simple. Just hooks with their pattern type as a headline.

```markdown
### [Pattern Name]
[Hook text]

### [Pattern Name]
[Hook text]

### [Pattern Name]
[Hook text]
```

**Example:**
```markdown
### Authority Credibility
I run a 23-person software agency. Here are 5 things I would never do again.

### Data-Driven Insight
I analyzed 1,000 LinkedIn posts. Here are the top 5 patterns that drove engagement.

### Contrarian
Everyone tells you to post daily. I posted 3x per week and got 10x more engagement.
```

---

## Defaults & Assumptions

Use these unless overridden.

- Number of hooks: 3
- Platform: X/Twitter (most restrictive character limit).
- Goal: Maximize engagement (likes, comments, shares).
- Audience: General business/entrepreneurship audience.
- Tone: Professional but conversational (matches most founders).
- Emotion: Curiosity (safest default for viral content).
- Format: Thread/post opener (not video hook).

---

## References

**These files MUST be read using the Read tool before generating any hooks (see Step 1 of Task Execution):**

| File | Purpose |
|------|---------|
| `./references/hook-patterns.md` | 18 proven hook patterns with templates, psychology, and Pattern Selection Matrix |
| `./references/trigger_words.md` | Viral trigger word categories (Insider, Helper, Thinker, Amplifiers) |

**Why both matter:** Hook patterns provide psychological structure. Trigger words amplify emotional impact. Patterns alone = good hook. Patterns + trigger words = viral hook (~10x more engagement).

---

## Quality Checklist (Self-Verification)

Before finalizing, verify ALL of the following:

### Pre-Generation Check
- [ ] I read `./references/hook-patterns.md` before generating hooks
- [ ] I read `./references/trigger_words.md` before generating hooks
- [ ] I have the 18 patterns and 4 trigger word categories in context

### Pattern & Structure Verification
- [ ] Each hook uses a proven pattern from hook-patterns.md (not made-up patterns)
- [ ] Each hook uses a DIFFERENT pattern (no repetition)
- [ ] Pattern templates were adapted to user context
- [ ] Hooks create genuine curiosity without being misleading

### Trigger Word Integration Verification
- [ ] Each hook contains 1-2 trigger words FROM THE FILE I READ
- [ ] Trigger words match pattern types appropriately
- [ ] Trigger words are integrated naturally (not forced)
- [ ] Trigger words enhance emotional impact

### Writing Rules Compliance
- [ ] Character limits respected for platform
- [ ] Specific numbers used (not "many" or "some")
- [ ] Active voice throughout
- [ ] No fluff or overused phrases

### Final Check
If ANY hook is missing trigger words from the reference file or uses patterns not from hook-patterns.md → revise before presenting.

---

© ognjengt · MIT · ognjengt/founder-skills

Similar skills

Everything for Marketing and content →

From the same set14

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor