/content-gen
Generate a promotion content pack from a project's PRD or README. Produces 3 ready-to-use content pieces: LinkedIn post, Reddit answer draft, and Twitter/X thread. For video scripts, use /video-promo.
MCP Tools (use if available)
kb_search(query)— find related methodology and principlesproject_info(name)— get project details, stack, descriptionproject_code_search(query, project)— find key features in codebase
If MCP tools are not available, fall back to Glob + Grep + Read.
Steps
- Parse project from
$ARGUMENTS.
- If project name: find PRD at docs/prd.md, or README.md, or CLAUDE.md. - If path: read directly. - If empty: ask via AskUserQuestion — "Which project to generate content for?"
- Extract core messaging from PRD/README (parallel reads):
- Problem: What pain does this solve? (1 sentence) - Solution: What does the product do? (1 sentence) - ICP: Who is the target user? (persona) - Key features: Top 3-5 differentiating features - Unique angle: What nobody else does (gap from research.md if exists) - Social proof: Any metrics, users, downloads (if available)
- Forced reasoning — messaging framework: Before generating content, write out:
- Hook: What stops the scroll? (pain point or surprising stat) - Proof: Why should they believe you? (demo, numbers, authority) - CTA: What's the one action? (try, sign up, download) - Tone: Based on ICP — casual/professional/technical/friendly
- Generate content pieces: 4a. LinkedIn Post Format: Hook line → Story (before/after) → Insight → CTA 4b. Reddit Answer Draft Format: Helpful answer that naturally mentions the product 4c. Twitter/X Thread (5-7 tweets) Format: Hook tweet → Problem → Solution → Demo → Social proof → CTA
- 1300-1500 chars max - First line is the hook (visible before "see more") - Use line breaks for readability - End with question to drive engagement - NOT promotional — value-first, product mention is secondary - Suggest 3-5 subreddits where this would be relevant - Write as if answering someone's genuine question - Include "disclaimer: I built this" transparency - Each tweet: 240-280 chars max - Tweet 1: standalone hook (works without thread) - Last tweet: CTA with link - Include emoji sparingly (1-2 per tweet max)
- Generate Release Notes (if project has git history):
git log --oneline --since="1 month ago" 2>/dev/null | head -20If commits exist, generate user-facing release notes: Format:## What's New (v{version}) **New** - {user-facing feature description} **Improved** - {improvement in user terms} **Fixed** - {bug fix in user terms}Include in content pack. If no git history, skip this section.
- Group by: New features, Improvements, Bug fixes - Translate technical commit messages into user language - Skip internal commits (chore, refactor, test, docs) - Keep tone consistent with ICP (casual for consumer, professional for B2B)
- Write content pack to
docs/content-pack.md: `# Content Pack: {Project Name} **Generated:** {YYYY-MM-DD} **ICP:** {target persona} **Core message:** {one-line value prop} ## Messaging Framework - **Hook:** {hook} - **Proof:** {proof} - **CTA:** {cta} --- ## 1. LinkedIn Post {ready to copy-paste} ## 2. Reddit Draft **Target subreddits:** r/..., r/..., r/... {answer draft} ## 3. Twitter/X Thread {numbered tweets} ## 4. Release Notes {release notes from step 5, or "No git history — skipped"} > For video script, run/video-promo {project}. --- *Generated by /content-gen. Edit before publishing.*` - Output summary — print core message + list of generated content pieces.
Notes
- All content is draft — always review before publishing
- Reddit draft should feel genuinely helpful, not promotional
- For video scripts, use
/video-promo(owns video generation entirely) - Rerun after major product updates to refresh messaging
- Works best with detailed PRD — falls back to README if no PRD
Gotchas
- LinkedIn algorithm penalizes external links — links in the post body reduce reach by 40-50%. Put the link in the FIRST COMMENT instead, and mention "link in comments" in the post.
- Twitter/X thread hooks must work standalone — tweet 1 appears alone in feeds without the thread. If it doesn't grab attention by itself, no one clicks "Show this thread".
- Reddit self-promotion rules — most subreddits enforce a 10:1 ratio (10 helpful comments per 1 promotional post). A brand-new account posting product links gets instantly removed.
- AI writing patterns are detectable — em dashes, "game-changer", "dive into", rule-of-three lists, "In today's fast-paced world". Run output through
/humanizebefore publishing. - Release notes ≠ changelog — user-facing release notes should describe BENEFITS ("faster checkout"), not technical changes ("refactored payment module"). Skip internal commits entirely.
Common Issues
No PRD found
Cause: Project doesn't have docs/prd.md or README. Fix: Provide a project path with PRD, or run /validate first to generate one.
Content too generic
Cause: PRD lacks specific differentiators or ICP details. Fix: Ensure PRD has detailed problem statement, ICP persona, and unique angle. Add research.md for competitive context.
Wrong tone for audience
Cause: ICP not clearly defined in PRD. Fix: Specify the target audience in PRD. LinkedIn = professional, Reddit = casual/technical, Twitter = punchy/conversational.