🪝 hooksmith

Forge scroll-stopping hooks for any product. Instantly.

18 proven copywriting frameworks. Zero dependencies. Zero API keys. Pure algorithmic hook generation.

npx hooksmith "AI marketing tool for small businesses"

---

⚡ Quickstart

# Run instantly (no install)
npx hooksmith "your product description"

# Or install globally
npm install -g hooksmith
hooksmith "your product description"

🎯 What You Get

🪝 hooksmith — 15 hooks for "AI marketing tool"

━━━ 🔮 CURIOSITY GAP ━━━
 1. What if your marketing wrote itself while you slept?
 2. What if one tool replaced your entire creative team?

━━━ 🛑 PATTERN INTERRUPT ━━━
 3. Stop hiring freelancers for every ad. Start generating them in seconds.

━━━ 💸 LOSS AVERSION ━━━
 4. You're burning $3,000/month on ads that a machine could write better.

━━━ 🏆 SOCIAL PROOF ━━━
 5. Apple uses this marketing strategy. Here's why you should too.

━━━ 🔥 CONTROVERSY ━━━
 6. Hot take: most marketing advice is wrong. Here's what actually works.

━━━ 🦋 TRANSFORMATION ━━━
 7. From low ROI to 5x growth: an AI marketing tool story.

── 7 frameworks · 7 hooks · hooksmith v1.0.0 ──

Every run is different. Hooks are randomized so you always get fresh ideas.

---

📖 CLI Reference

hooksmith <product-description> [options]

Flag	Short	Description	Default
--help	-h	Show help	—
--version	-v	Show version	—
--list	-l	List all frameworks	—
--frameworks	-f	Comma-separated framework IDs	all
--count	-c	Number of hooks to generate	15
--platform	-p	Target platform	default
--json	—	Output as JSON	false
--copy	—	Copy first hook to clipboard	false

Examples

# Generate 15 hooks (default)
hooksmith "AI marketing tool for small businesses"

# Pick specific frameworks
hooksmith "premium coffee brand" --frameworks curiosity,fear,story

# Generate more hooks
hooksmith "SaaS project management" --count 20

# Platform-optimized
hooksmith "fitness app" --platform tiktok
hooksmith "B2B software" --platform linkedin

# Machine-readable output
hooksmith "e-commerce platform" --json

# Copy best hook to clipboard
hooksmith "productivity app" --copy

# List all available frameworks
hooksmith --list

---

🎭 18 Proven Frameworks

ID	Name	Pattern
curiosity	🔮 Curiosity Gap	"What if [X] could [Y]?"
interrupt	🛑 Pattern Interrupt	"Stop [doing X]. Start [doing Y]."
authority	⚠️ Fear/Authority	"The #1 mistake [audience] make with [topic]"
story	📖 Story/Curiosity	"I tried [X] for 30 days. Here's what happened."
listicle	📋 Listicle	"[Number] [things] that [surprising outcome]"
insider	🤫 Insider Knowledge	"Most [audience] don't know [secret]"
loss	💸 Loss Aversion	"You're losing [money/time] every time you [action]"
social	🏆 Social Proof	"[Famous brand] uses this strategy. Here's why."
urgency	⏰ Urgency/FOMO	"In 2026, [old way] is dead. Here's what's replacing it."
benefit	✨ Benefit-Pain	"The [adj] way to [outcome] without [pain point]"
fear	🚨 Fear	"Warning: [consequence] if you [action]"
controversy	🔥 Controversy	"[Contrarian take] — and here's the proof"
transformation	🦋 Transformation	"How [person] went from [bad] to [good]"
silverbullet	🎯 Silver Bullet	"This one [thing] changed everything about [topic]"
expose	🕵️ Exposé	"Nobody talks about [hidden truth] in [industry]"
aspirational	🌟 Aspirational	"POV: You just [did desirable thing]"
thread	🧵 Thread Hook	"🔥 [Bold claim]. Here's the breakdown:"
opportunity	💎 Opportunity Cost	"If you're [audience] and not [doing X], you're leaving [value] on the table"

---

📱 Platform Smart

hooksmith adapts hooks for each platform's style:

Platform	--platform	Style
TikTok	tiktok	Short, punchy, max 80 chars. Scroll-stopping.
Twitter/X	twitter	Sharp and concise. Under 200 chars.
LinkedIn	linkedin	Professional tone. No slang or hot takes.
Facebook	facebook	Emotional, personal, story-driven.
Default	—	Balanced. Works everywhere.

# Same product, different platforms
hooksmith "project management tool" --platform tiktok
hooksmith "project management tool" --platform linkedin

---

🧠 How It Works

1. Parse — Extracts key nouns, industry, audience, and benefits from your product description
2. Match — Maps your product to relevant industries, pain points, and competitor references
3. Generate — Fills 18 proven hook templates with intelligent, context-aware copy
4. Adapt — Adjusts tone, length, and vocabulary for your target platform
5. Randomize — Shuffles and varies output so every run gives fresh hooks

No AI. No API calls. No internet required. Just smart templates + NLP-lite parsing.

---

🤔 Why hooksmith?

	hooksmith	ChatGPT	Copywriter
Speed	Instant	5-30 sec	1-3 days
Cost	Free	$20/mo+	$500+
Offline	✅	❌	❌
Consistent	✅	Varies	Varies
Frameworks	18 proven	Whatever it feels like	Depends
API key	None	Required	N/A

hooksmith isn't a replacement for human creativity — it's a starting point. Use it to generate ideas fast, then refine the ones that resonate.

---

🔧 Programmatic Use

const { generateHooks } = require('hooksmith');

const result = generateHooks('AI marketing tool', {
  frameworks: ['curiosity', 'loss', 'social'],
  count: 10,
  platform: 'twitter',
});

console.log(result.groups); // Array of { framework, hooks }

---

🤝 Contributing

Contributions welcome! Here's how:

1. Fork the repo
2. Create a feature branch (git checkout -b add-new-framework)
3. Add your framework to lib/frameworks.js
4. Test with node bin/cli.js "test product"
5. Open a PR

Adding a New Framework

Each framework in lib/frameworks.js needs:

• id — unique lowercase key
• name — display name (UPPERCASE)
• emoji — single emoji icon
• description — pattern description
• generate(ctx, platform) — function returning array of hook strings

---

📄 License

MIT © SlashImagine

---

Built with 🪝 by SlashImagine
Website · Issues · npm