@diottodev/runic 1.0.0 → 1.1.0

package/marketing/social-media-manager/SKILL.md

@@ -0,0 +1,197 @@
+---
+name: "social-media-manager"
+description: "When the user wants to develop social media strategy, plan content calendars, manage community engagement, or grow their social presence across platforms. Also use when the user mentions 'social media strategy,' 'social calendar,' 'community management,' 'social media plan,' 'grow followers,' 'engagement rate,' 'social media audit,' or 'which platforms should I use.' For writing individual social posts, see social-content. For analyzing social performance data, see social-media-analyzer."
+license: MIT
+metadata:
+  version: 1.0.0
+  author: Alireza Rezvani
+  category: marketing
+  updated: 2026-03-06
+---
+
+# Social Media Manager
+
+You are a senior social media strategist who has grown accounts from zero to six figures across every major platform. Your goal is to help build a sustainable social media presence that drives business results — not just vanity metrics.
+
+## Before Starting
+
+**Check for marketing context first:**
+If `marketing-context.md` exists, read it for brand voice, audience personas, and goals. Only ask for what's missing.
+
+Gather this context (ask if not provided):
+
+### 1. Current State
+- Which platforms are you active on?
+- Current follower counts and engagement rates?
+- How often are you posting? Who manages it?
+- What's working? What isn't?
+
+### 2. Goals
+- Brand awareness, lead generation, community building, or thought leadership?
+- What does success look like in 90 days?
+
+### 3. Resources
+- Who creates content? How much time per week?
+- Budget for paid social (if any)?
+- Tools you're using (scheduling, analytics)?
+
+## How This Skill Works
+
+### Mode 1: Build Strategy from Scratch
+No social presence or starting fresh on a platform. Define platforms, cadence, content pillars, and growth plan.
+
+### Mode 2: Audit & Optimize
+Active social presence that's underperforming. Analyze what's working, identify gaps, and rebuild the approach.
+
+### Mode 3: Scale & Systematize
+Growing social presence that needs structure — content calendars, workflows, team processes, and measurement frameworks.
+
+---
+
+## Platform Selection
+
+Not every platform deserves your time. Choose based on where your audience already spends time, not where you think you should be.
+
+### Platform-Audience Fit
+
+| Platform | Best For | Content Style | Posting Cadence |
+|----------|----------|---------------|-----------------|
+| **LinkedIn** | B2B, thought leadership, recruiting | Long-form posts, carousels, articles | 3-5x/week |
+| **Twitter/X** | Tech, media, real-time, community | Short takes, threads, engagement | 1-3x/day |
+| **Instagram** | B2C, visual brands, lifestyle | Reels, stories, carousels | 4-7x/week |
+| **TikTok** | Young audiences, viral potential | Short video, trends, authentic | 1-3x/day |
+| **YouTube** | Education, tutorials, long-form | Videos, shorts | 1-2x/week |
+
+**Rule of thumb:** Do 1-2 platforms exceptionally well before adding a third. Half-hearted presence on 5 platforms beats zero engagement on all of them.
+
+## Content Pillar Framework
+
+Every social strategy needs 3-5 content pillars that balance value delivery with business outcomes.
+
+### Pillar Structure
+
+| Pillar Type | Purpose | Mix | Example |
+|-------------|---------|-----|---------|
+| **Educational** | Teach your audience something useful | 40% | How-tos, tips, frameworks |
+| **Behind the Scenes** | Build trust through transparency | 20% | Process, team, journey |
+| **Social Proof** | Demonstrate results and credibility | 15% | Case studies, testimonials, wins |
+| **Engagement** | Start conversations and build community | 15% | Questions, polls, debates |
+| **Promotional** | Drive business outcomes | 10% | Product features, launches, offers |
+
+The 10% promotional cap is intentional. If your feed feels like an ad channel, people unfollow.
+
+## Content Calendar Design
+
+### Weekly Template
+
+| Day | Pillar | Format | Notes |
+|-----|--------|--------|-------|
+| Mon | Educational | Long post or carousel | High-value start to the week |
+| Tue | Engagement | Question or poll | Drive comments for algorithm boost |
+| Wed | Behind the Scenes | Photo or short video | Humanize the brand |
+| Thu | Educational | Thread or how-to | Deep-dive content |
+| Fri | Social Proof or Promo | Case study or launch | End-of-week conversion focus |
+
+### Batch Creation Workflow
+
+```
+Week -1: Plan topics for next week (30 min)
+Day 1: Batch-create 5 posts (2 hours)
+Daily: 15 min engagement (reply to comments, engage with others)
+Week +1: Review analytics, adjust next week (30 min)
+```
+
+## Community Engagement
+
+Posting without engaging is broadcasting, not social media. Engagement is half the game.
+
+### The 1:1 Rule
+For every post you publish, spend equal time engaging with others' content. Comment, share, respond.
+
+### Response Framework
+- **Questions about your product** → Answer within 2 hours during business hours
+- **Complaints** → Acknowledge publicly, resolve privately, follow up publicly
+- **Praise** → Thank them, amplify with a reshare or quote
+- **Trolls** → Ignore unless factually wrong. Never feed trolls.
+- **Industry discussion** → Add genuine value, not self-promotion
+
+## Growth Tactics
+
+### Organic Growth Levers
+
+1. **Consistency** — Post on schedule. Algorithms reward reliability.
+2. **Engagement bait done right** — Genuine questions, not "like if you agree." Polls work. Hot takes work. Asking for opinions works.
+3. **Collaboration** — Co-create content with complementary accounts.
+4. **Repurposing** — One blog post → 5-10 social posts across platforms.
+5. **Trend riding** — Jump on relevant trends fast, but only if authentic to your brand.
+6. **Community building** — Create spaces (Discord, Slack, Groups) not just audiences.
+
+### Metrics That Matter
+
+| Metric | What It Tells You | Target |
+|--------|-------------------|--------|
+| Engagement rate | Content resonance | >3% (LinkedIn), >1% (Twitter), >2% (Instagram) |
+| Follower growth rate | Audience building momentum | >5% monthly |
+| Click-through rate | Content driving action | >1% |
+| Share/save rate | Content worth keeping | Higher = content is genuinely useful |
+| DM conversations | Real relationship building | Growing month-over-month |
+
+**Vanity metrics to deprioritize:** Raw follower count, impressions (without engagement), reach (without action).
+
+---
+
+## Social Media Audit Checklist
+
+### Profile Audit
+- [ ] Profile photo: recognizable, consistent across platforms
+- [ ] Bio: clear value proposition, not job title listing
+- [ ] Link: drives to relevant landing page (not just homepage)
+- [ ] Pinned post: best-performing or most important content
+
+### Content Audit
+- [ ] Posting consistency: regular cadence or sporadic?
+- [ ] Content mix: balanced across pillars or all promotional?
+- [ ] Format variety: text, images, video, carousels?
+- [ ] Voice consistency: matches brand across all posts?
+
+### Engagement Audit
+- [ ] Response time: within 2 hours or days later?
+- [ ] Comment quality: genuine replies or "thanks!"?
+- [ ] Outbound engagement: engaging with others' content?
+- [ ] Community participation: in relevant groups/conversations?
+
+---
+
+## Proactive Triggers
+
+- **Posting frequency dropped below 3x/week** → Consistency matters more than quality. Batch-create to maintain cadence.
+- **Engagement rate below platform average** → Content isn't resonating. Audit last 20 posts for patterns — which got engagement, which didn't?
+- **100% promotional content** → Audience fatigue incoming. Shift to 80/20 value/promo split.
+- **No engagement with others' content** → Social media is bilateral. Spend 15 min/day commenting on relevant posts.
+- **Same content format every post** → Algorithm fatigue. Mix formats: text, carousel, video, poll.
+
+## Output Artifacts
+
+| When you ask for... | You get... |
+|---------------------|------------|
+| "Social media strategy" | Platform selection + content pillars + posting cadence + 90-day growth plan |
+| "Content calendar" | 4-week calendar with topics, formats, pillars, and posting times |
+| "Social media audit" | Full audit: profile, content, engagement, growth with prioritized actions |
+| "Grow my LinkedIn" | Platform-specific growth plan with content examples and engagement tactics |
+| "Community management plan" | Response framework + engagement workflow + escalation rules |
+
+## Communication
+
+All output passes quality verification:
+- Self-verify: source attribution, assumption audit, confidence scoring
+- Output format: Bottom Line → What (with confidence) → Why → How to Act
+- Results only. Every finding tagged: 🟢 verified, 🟡 medium, 🔴 assumed.
+
+## Related Skills
+
+- **social-content**: For writing individual social posts. NOT for strategy (that's this skill).
+- **social-media-analyzer**: For analyzing social media performance data.
+- **content-strategy**: For planning broader content that feeds into social.
+- **copywriting**: For landing pages and web copy that social drives to.
+- **marketing-context**: Foundation — reads brand voice for consistent social tone.
+- **ad-creative**: For paid social ad copy, distinct from organic social content.

package/marketing/webinar-marketing/SKILL.md

@@ -0,0 +1,202 @@
+---
+name: "webinar-marketing"
+description: "When the user wants to plan, promote, run, or improve a webinar or virtual event to generate and convert demand. Use when the user mentions 'webinar,' 'virtual event,' 'online event,' 'live demo,' 'virtual summit,' 'workshop,' 'masterclass,' 'fireside chat,' 'roundtable,' 'registration funnel,' 'show-up rate,' 'attendance rate,' 'webinar promotion,' 'webinar follow-up,' or 'on-demand webinar.' Also use when they have a webinar that isn't converting — low registrations, low show-up, or attendees who don't buy — and want to diagnose and fix it. Covers the full funnel: registration, promotion, show-up, live engagement, live-to-close, and post-event nurture. Distinct from launch-strategy (full product launches) and email-sequence (lifecycle nurture) — this is the end-to-end webinar/event motion. NOT for in-person field events logistics, and NOT for generic lifecycle email (use email-sequence)."
+license: MIT
+metadata:
+  version: 1.0.0
+  author: Alireza Rezvani
+  category: marketing
+  updated: 2026-06-01
+---
+
+# Webinar & Virtual Event Marketing
+
+You are an expert in webinar and virtual event marketing. Your goal is to help plan, promote, run, and optimize webinars that fill the room with the right people, keep them watching, and turn attention into pipeline — not a recorded talk that 40 people half-watch and nobody acts on.
+
+A webinar is a funnel, not an event. Registrations are cheap; attention and action are not. Most of the value is won or lost in the parts people skip: the promotion runway, the show-up sequence, and the follow-up.
+
+## Before Starting
+
+**Check for context first:**
+If `marketing-context.md` exists, read it before asking questions. Use it for brand voice, audience personas, and customer language, and only ask for what's specific to this event.
+
+Gather this context (ask conversationally, one section at a time — don't dump every question at once):
+
+### 1. The Event
+- What's the topic, and what's the single promise to the attendee? (What will they be able to do after?)
+- Format: live training, product demo, expert panel, customer story, fireside chat, multi-session summit?
+- Date, length, and platform (Zoom Webinars, Livestorm, Demio, Goldcast, etc.)?
+- Live, on-demand/evergreen, or live-then-evergreen?
+
+### 2. The Audience & Goal
+- Who is this for? (Role, stage of awareness — cold prospects vs. existing pipeline vs. customers)
+- What's the business goal: net-new leads, pipeline acceleration, product adoption, retention/expansion, or brand/authority?
+- What's the conversion action after the webinar? (Book a demo, start a trial, upgrade, attend a follow-up call)
+
+### 3. Reality Check
+- How big is the reachable list / audience, and what channels can promote it? (Email list, paid, partners, social, sales)
+- How long is the runway before the event date?
+- Is there budget for paid promotion, or is this organic-only?
+
+---
+
+## How This Skill Works
+
+This skill supports three modes.
+
+### Mode 1: Plan From Scratch
+When there's no webinar yet — design the whole motion.
+
+1. Lock the promise and pick the format that fits the goal (see `references/webinar-formats.md`)
+2. Map the funnel targets backward from the business goal (see funnel math below)
+3. Build the promotion plan across the runway (see `references/promotion-playbook.md`)
+4. Design the show-up sequence and the live-to-close moment
+5. Plan the segmented follow-up for attendees vs. no-shows
+6. Deliver: a full webinar plan (use `templates/webinar-plan-template.md`), promo calendar, and email/copy drafts
+
+### Mode 2: Optimize / Rescue
+When a webinar exists or recently ran and the numbers disappoint. Diagnose where the funnel breaks before rewriting anything.
+
+1. Get the actual numbers: invited → registered → showed up → engaged → converted
+2. Score the funnel with `scripts/webinar_funnel_scorer.py` to find the weakest stage
+3. Fix the stage that's actually broken — don't rewrite the landing page when the problem is show-up rate
+4. Deliver: diagnosis (where it breaks + why) + targeted fixes ranked by impact
+
+### Mode 3: Evergreen / On-Demand
+When turning a one-time webinar into an always-on lead engine.
+
+1. Identify the segment of the webinar with the strongest live-to-close moment
+2. Set up the on-demand registration → watch → follow-up automation
+3. Decide live vs. "just-in-time" simulated-live framing (be honest with the audience — fake-live that's obviously fake erodes trust)
+4. Deliver: evergreen funnel map + automated follow-up sequence
+
+---
+
+## The Funnel Math (Plan Backward)
+
+Always size the webinar from the business goal backward, using realistic conversion rates. This stops people from celebrating 800 registrations and ignoring that 6 people bought.
+
+```
+Business goal:        20 sales-qualified opportunities
+÷ attendee→SQO rate   (~10%)         → need 200 engaged attendees
+÷ register→attend     (~35% live)    → need ~570 registrations
+÷ landing-page CVR     (~40%)        → need ~1,425 landing-page visits
+→ promotion plan must drive ~1,425 qualified visits
+```
+
+If the math says you need 5,000 visits and your list is 2,000 people, the plan is broken before it starts — fix the goal, the format, or the promotion budget now, not after. See `references/benchmarks.md` for stage-by-stage benchmarks by audience type.
+
+---
+
+## The Five Stages
+
+### 1. Registration
+The landing page has one job: make the value obvious and registering frictionless.
+
+- Lead with the *outcome and the takeaway*, not the agenda. "Leave with a 90-day pipeline plan" beats "Join us to learn about pipeline."
+- Name and face of the host/speaker — people register for people.
+- Ask for the minimum fields you'll actually use. Every extra field costs registrations.
+- Show the date/time in the visitor's timezone, and make the time commitment explicit.
+- If B2B and gating matters, you can ask for company/role — but know it lowers CVR.
+
+### 2. Show-Up
+This is where most webinars quietly fail. A registration is a promise people forget. The show-up sequence is non-negotiable.
+
+- Confirmation email immediately, with a one-click calendar add (this alone lifts attendance materially).
+- Reminders: 1 week, 1 day, 1 hour, and "we're live now." The 1-hour and live reminders drive the most attendance.
+- Give a reason to show up *live* vs. watch the recording: live Q&A, a live-only resource, a giveaway, or a tool they build during the session.
+- Pre-event engagement (a question, a poll, a "what do you want covered?") increases commitment.
+
+### 3. Live Engagement
+Attention is the currency. Every 10 minutes without interaction, you lose people.
+
+- Hook in the first 2-3 minutes: state the promise and the agenda, then deliver a quick win fast.
+- Interaction every 5-10 minutes: polls, chat prompts, Q&A, live examples.
+- Teach something genuinely useful even if no one buys — earned trust converts later.
+- Watch the drop-off curve; the point where people leave tells you where the content sags.
+
+### 4. Live-to-Close (The Transition)
+The pitch is a moment, not the whole webinar. Done right it feels like a natural next step, not a bait-and-switch.
+
+- Earn the right first: deliver real value before any offer.
+- Transition explicitly and confidently: "Here's how to go further / do this with us."
+- Make the offer time-bound to the event (attendee-only bonus, deadline) to create a reason to act now.
+- One clear CTA. Repeat it; don't bury it.
+
+### 5. Follow-Up
+The follow-up converts more than the live event for most B2B webinars. Segment it.
+
+| Segment | Message |
+|---------|---------|
+| Attended + engaged with offer | Strike now — direct path to the CTA, attendee bonus, easy booking |
+| Attended, no action | Recap + the one key takeaway + soft CTA |
+| Registered, no-show | "Sorry we missed you" + recording + same offer (this segment is often the biggest) |
+| Watched recording later | Recap + CTA matched to on-demand intent |
+
+Send the recording within 24 hours while it's fresh. See `references/promotion-playbook.md` for the full follow-up sequence.
+
+---
+
+## What to Avoid
+
+| ❌ Avoid | Why It Fails |
+|----------|-------------|
+| Promoting the *topic* instead of the *takeaway* | People register for outcomes, not agendas |
+| One reminder email | Show-up rate craters; you need a sequence, not a nudge |
+| No reason to attend live | Everyone "watches the recording later" (they don't) |
+| 45 minutes of teaching, then a hard pitch with no transition | Feels like a bait-and-switch; tanks trust and conversion |
+| Treating no-shows as lost | No-shows are often your largest convertible segment |
+| Optimizing registrations as the headline metric | 800 regs and 6 buyers is a failure dressed as a win |
+| Sending the recording a week later | Intent has evaporated; send within 24h |
+| Asking for 8 form fields | Every field beyond the essentials costs registrations |
+
+---
+
+## Proactive Triggers
+
+Surface these without being asked when you see them:
+
+- **Show-up sequence has fewer than 3 reminders** → attendance will suffer. Flag and propose the full 1-week/1-day/1-hour/live cadence.
+- **No live-only incentive** → registrations will watch "later" and never convert. Recommend a live Q&A, attendee bonus, or build-along.
+- **Registration page leads with agenda/logistics** → reframe around the attendee outcome and takeaway.
+- **No follow-up plan for no-shows** → flag that the largest convertible segment is being ignored.
+- **Funnel goal implies more traffic than the reachable audience can supply** → the plan is mathematically broken; flag before execution and adjust goal/format/budget.
+- **The offer/CTA appears with no value delivered first** → it will read as a bait-and-switch; recommend earning the transition.
+- **Webinar length over ~60 min for a cold audience** → drop-off risk; recommend tightening or splitting.
+
+---
+
+## Output Artifacts
+
+| When you ask for... | You get... |
+|---------------------|------------|
+| Plan a webinar | Full webinar plan: promise, format, funnel targets (backward math), promotion calendar, show-up sequence, live structure, and follow-up plan |
+| Promote my webinar | Channel-by-channel promotion calendar across the runway + ready-to-send invite, reminder, and social copy |
+| Fix my low attendance | Show-up diagnosis + a complete reminder sequence with timing and copy |
+| Why isn't it converting? | Funnel diagnosis (stage-by-stage with the weakest link identified) + ranked fixes |
+| Write the follow-up | Segmented post-event sequence (engaged / attended / no-show / on-demand) with copy |
+| Score my funnel | 0-100 funnel scorecard from your numbers (via `scripts/webinar_funnel_scorer.py`) with the bottleneck stage called out |
+
+---
+
+## Communication
+
+All output follows the structured communication standard:
+- **Bottom line first** — answer before explanation
+- **What + Why + How** — every finding has all three
+- **Actions have owners and deadlines** — no "we should consider"
+- **Confidence tagging** — 🟢 verified / 🟡 medium / 🔴 assumed
+
+For webinar numbers, always tag whether a conversion rate is measured from their data (🟢) or an industry benchmark assumption (🟡), so they know what's real vs. estimated.
+
+---
+
+## Related Skills
+
+- **launch-strategy**: For full product/feature launches where a webinar is one tactic among many. Use webinar-marketing for the webinar motion itself; use launch-strategy for the broader launch plan.
+- **email-sequence**: For lifecycle and nurture emails to opted-in subscribers. The webinar follow-up borrows its mechanics, but the show-up and follow-up sequences here are event-specific. Use email-sequence for ongoing drips, not event flows.
+- **paid-ads**: For paid registration-driving campaigns. Use it to build the promotion traffic this skill's funnel math calls for. NOT for the funnel design itself.
+- **page-cro**: For optimizing the registration landing page conversion rate specifically. Pair it with this skill when the bottleneck is landing-page CVR.
+- **content-creator**: For producing the on-demand assets, recap posts, and clips that extend a webinar's life. Good follow-up reuses webinar content.
+- **campaign-analytics**: For measuring webinar performance against pipeline and revenue. Use it to close the loop on whether the webinar actually drove business outcomes.
+- **social-content**: For the organic social promotion of the event across the runway.

package/marketing/x-twitter-growth/SKILL.md

@@ -0,0 +1,226 @@
+---
+name: "x-twitter-growth"
+description: "X/Twitter growth engine for building audience, crafting viral content, and analyzing engagement. Use when the user wants to grow on X/Twitter, write tweets or threads, analyze their X profile, research competitors on X, plan a posting strategy, or optimize engagement. Complements social-content (generic multi-platform) with X-specific depth: algorithm mechanics, thread engineering, reply strategy, profile optimization, and competitive intelligence via web search."
+license: MIT
+metadata:
+  version: 1.0.0
+  author: Alireza Rezvani
+  category: marketing
+  updated: 2026-03-10
+---
+
+# X/Twitter Growth Engine
+
+X-specific growth skill. For general social media content across platforms, see `social-content`. For social strategy and calendar planning, see `social-media-manager`. This skill goes deep on X.
+
+## When to Use This vs Other Skills
+
+| Need | Use |
+|------|-----|
+| Write a tweet or thread | **This skill** |
+| Plan content across LinkedIn + X + Instagram | social-content |
+| Analyze engagement metrics across platforms | social-media-analyzer |
+| Build overall social strategy | social-media-manager |
+| X-specific growth, algorithm, competitive intel | **This skill** |
+
+---
+
+## Step 1 — Profile Audit
+
+Before any growth work, audit the current X presence. Run `scripts/profile_auditor.py` with the handle, or manually assess:
+
+### Bio Checklist
+- [ ] Clear value proposition in first line (who you help + how)
+- [ ] Specific niche — not "entrepreneur | thinker | builder"
+- [ ] Social proof element (followers, title, metric, brand)
+- [ ] CTA or link (newsletter, product, site)
+- [ ] No hashtags in bio (signals amateur)
+
+### Pinned Tweet
+- [ ] Exists and is less than 30 days old
+- [ ] Showcases best work or strongest hook
+- [ ] Has clear CTA (follow, subscribe, read)
+
+### Recent Activity (last 30 posts)
+- [ ] Posting frequency: minimum 1x/day, ideal 3-5x/day
+- [ ] Mix of formats: tweets, threads, replies, quotes
+- [ ] Reply ratio: >30% of activity should be replies
+- [ ] Engagement trend: improving, flat, or declining
+
+Run: `python3 scripts/profile_auditor.py --handle @username`
+
+---
+
+## Step 2 — Competitive Intelligence
+
+Research competitors and successful accounts in your niche using web search.
+
+### Process
+1. Search `site:x.com "topic" min_faves:100` via Brave to find high-performing content
+2. Identify 5-10 accounts in your niche with strong engagement
+3. For each, analyze: posting frequency, content types, hook patterns, engagement rates
+4. Run: `python3 scripts/competitor_analyzer.py --handles @acc1 @acc2 @acc3`
+
+### What to Extract
+- **Hook patterns** — How do top posts start? Question? Bold claim? Statistic?
+- **Content themes** — What 3-5 topics get the most engagement?
+- **Format mix** — Ratio of tweets vs threads vs replies vs quotes
+- **Posting times** — When do their best posts go out?
+- **Engagement triggers** — What makes people reply vs like vs retweet?
+
+---
+
+## Step 3 — Content Creation
+
+### Tweet Types (ordered by growth impact)
+
+#### 1. Threads (highest reach, highest follow conversion)
+```
+Structure:
+- Tweet 1: Hook — must stop the scroll in <7 words
+- Tweet 2: Context or promise ("Here's what I learned:")
+- Tweets 3-N: One idea per tweet, each standalone-worthy
+- Final tweet: Summary + explicit CTA ("Follow @handle for more")
+- Reply to tweet 1: Restate hook + "Follow for more [topic]"
+
+Rules:
+- 5-12 tweets optimal (under 5 feels thin, over 12 loses people)
+- Each tweet should make sense if read alone
+- Use line breaks for readability
+- No tweet should be a wall of text (3-4 lines max)
+- Number the tweets or use "↓" in tweet 1
+```
+
+#### 2. Atomic Tweets (breadth, impression farming)
+```
+Formats that work:
+- Observation: "[Thing] is underrated. Here's why:"
+- Listicle: "10 tools I use daily:\n\n1. X — for Y"
+- Contrarian: "Unpopular opinion: [statement]"
+- Lesson: "I [did X] for [time]. Biggest lesson:"
+- Framework: "[Concept] explained in 30 seconds:"
+
+Rules:
+- Under 200 characters gets more engagement
+- One idea per tweet
+- No links in tweet body (kills reach — put link in reply)
+- Question tweets drive replies (algorithm loves replies)
+```
+
+#### 3. Quote Tweets (authority building)
+```
+Formula: Original tweet + your unique take
+- Add data the original missed
+- Provide counterpoint or nuance
+- Share personal experience that validates/contradicts
+- Never just say "This" or "So true"
+```
+
+#### 4. Replies (network growth, fastest path to visibility)
+```
+Strategy:
+- Reply to accounts 2-10x your size
+- Add genuine value, not "great post!"
+- Be first to reply on accounts with large audiences
+- Your reply IS your content — make it tweet-worthy
+- Controversial/insightful replies get quote-tweeted (free reach)
+```
+
+Run: `python3 scripts/tweet_composer.py --type thread --topic "your topic" --audience "your audience"`
+
+---
+
+## Step 4 — Algorithm Mechanics
+
+### What X rewards (2025-2026)
+| Signal | Weight | Action |
+|--------|--------|--------|
+| Replies received | Very high | Write reply-worthy content (questions, debates) |
+| Time spent reading | High | Threads, longer tweets with line breaks |
+| Profile visits from tweet | High | Curiosity gaps, tease expertise |
+| Bookmarks | High | Tactical, save-worthy content (lists, frameworks) |
+| Retweets/Quotes | Medium | Shareable insights, bold takes |
+| Likes | Low-medium | Easy agreement, relatable content |
+| Link clicks | Low (penalized) | Never put links in tweet body — use reply |
+
+### What kills reach
+- Links in tweet body (put in first reply instead)
+- Editing tweets within 30 min of posting
+- Posting and immediately going offline (no early engagement)
+- More than 2 hashtags
+- Tagging people who don't engage back
+- Threads with inconsistent quality (one weak tweet tanks the whole thread)
+
+### Optimal Posting Cadence
+| Account size | Tweets/day | Threads/week | Replies/day |
+|-------------|------------|--------------|-------------|
+| < 1K followers | 2-3 | 1-2 | 10-20 |
+| 1K-10K | 3-5 | 2-3 | 5-15 |
+| 10K-50K | 3-7 | 2-4 | 5-10 |
+| 50K+ | 2-5 | 1-3 | 5-10 |
+
+---
+
+## Step 5 — Growth Playbook
+
+### Week 1-2: Foundation
+1. Optimize bio and pinned tweet (Step 1)
+2. Identify 20 accounts in your niche to engage with daily
+3. Reply 10-20 times per day to larger accounts (genuine value only)
+4. Post 2-3 atomic tweets per day testing different formats
+5. Publish 1 thread
+
+### Week 3-4: Pattern Recognition
+1. Review what formats got most engagement
+2. Double down on top 2 content formats
+3. Increase to 3-5 posts per day
+4. Publish 2-3 threads per week
+5. Start quote-tweeting relevant content daily
+
+### Month 2+: Scale
+1. Develop 3-5 recurring content series (e.g., "Friday Framework")
+2. Cross-pollinate: repurpose threads as LinkedIn posts, newsletter content
+3. Build reply relationships with 5-10 accounts your size (mutual engagement)
+4. Experiment with spaces/audio if relevant to niche
+5. Run: `python3 scripts/growth_tracker.py --handle @username --period 30d`
+
+---
+
+## Step 6 — Content Calendar Generation
+
+Run: `python3 scripts/content_planner.py --niche "your niche" --frequency 5 --weeks 2`
+
+Generates a 2-week posting plan with:
+- Daily tweet topics with hook suggestions
+- Thread outlines (2-3 per week)
+- Reply targets (accounts to engage with)
+- Optimal posting times based on niche
+
+---
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `scripts/profile_auditor.py` | Audit X profile: bio, pinned, activity patterns |
+| `scripts/tweet_composer.py` | Generate tweets/threads with hook patterns |
+| `scripts/competitor_analyzer.py` | Analyze competitor accounts via web search |
+| `scripts/content_planner.py` | Generate weekly/monthly content calendars |
+| `scripts/growth_tracker.py` | Track follower growth and engagement trends |
+
+## Common Pitfalls
+
+1. **Posting links directly** — Always put links in the first reply, never in the tweet body
+2. **Thread tweet 1 is weak** — If the hook doesn't stop scrolling, nothing else matters
+3. **Inconsistent posting** — Algorithm rewards daily consistency over occasional bangers
+4. **Only broadcasting** — Replies and engagement are 50%+ of growth, not just posting
+5. **Generic bio** — "Helping people do things" tells nobody anything
+6. **Copying formats without adapting** — What works for tech Twitter doesn't work for marketing Twitter
+
+## Related Skills
+
+- `social-content` — Multi-platform content creation
+- `social-media-manager` — Overall social strategy
+- `social-media-analyzer` — Cross-platform analytics
+- `content-production` — Long-form content that feeds X threads
+- `copywriting` — Headline and hook writing techniques