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.
npx skills add ognjengt/founder-skills --skill viral-hook-creator -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/viral-hook-creator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/viral-hook-creator/
1Skills CLI (Vercel)
npx skills add ognjengt/founder-skills --skill viral-hook-creator -a codex2Manually: put the files in place
.agents/skills/viral-hook-creator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ognjengt/founder-skills --skill viral-hook-creator -a cursor2Manually: put the files in place
.cursor/skills/viral-hook-creator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ognjengt/founder-skills viral-hook-creator2Manually: put the files in place
.github/skills/viral-hook-creator/SKILL.md1Skills CLI (Vercel)
npx skills add ognjengt/founder-skills --skill viral-hook-creator -a gemini-cli2Platform CLI
gemini skills install https://github.com/ognjengt/founder-skills --path skills/viral-hook-creatorManually: put the files in place
.devin/skills/viral-hook-creator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ognjengt/founder-skills --skill viral-hook-creator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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