solo-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 principles
• project_info(name) — get project details, stack, description
• project_code_search(query, project) — find key features in codebase

If MCP tools are not available, fall back to Glob + Grep + Read.

Steps

1. 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?"

2. 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)

3. 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

4. Generate content pieces:

   4a. LinkedIn Post

   Format: Hook line → Story (before/after) → Insight → 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

   4b. Reddit Answer Draft

   Format: Helpful answer that naturally mentions the product

   • 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

   4c. Twitter/X Thread (5-7 tweets)

   Format: Hook tweet → Problem → Solution → Demo → Social proof → CTA

   • 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)

5. Generate Release Notes (if project has git history):

   git log --oneline --since="1 month ago" 2>/dev/null | head -20
   

   If commits exist, generate user-facing release notes:

   • 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)

   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.

6. 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.*
   

7. 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

1. 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.
2. 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".
3. 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.
4. AI writing patterns are detectable — em dashes, "game-changer", "dive into", rule-of-three lists, "In today's fast-paced world". Run output through /humanize before publishing.
5. 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.