@rfxlamia/skillkit 1.0.0 → 1.2.0

package/skills/skills/social-media-seo/references/threads-seo.md

@@ -0,0 +1,305 @@
+# Threads SEO Playbook (2025)
+
+Optimization guide for Meta's Threads platform. Reflects platform evolution as of December 2025.
+
+## Platform Context
+
+**Threads = Meta's Twitter Competitor:**
+- Launched July 2023, rapid growth in 2024-2025
+- Tight integration with Instagram (same account base)
+- Algorithm prioritizes conversation over virality
+- SEO features still evolving (younger platform)
+
+**Key Difference from X/Twitter:**
+- Less emphasis on trending topics
+- More focus on community/niche conversations
+- Cross-platform synergy with Instagram
+
+## Profile Optimization
+
+### Username & Display Name
+**Synchronized with Instagram:**
+- Same username as Instagram (can't differ)
+- Display name can be different
+- Bio separate from Instagram
+
+**Strategy:**
+- If Instagram optimized → Threads inherits benefits
+- If not → Optimize Instagram first
+
+### Bio Optimization
+
+**Format:** `[What you do] • [Who for] • [Value]`
+
+**Example:**
+```
+Social media SEO tips • Helping creators get discovered • DM for resources
+```
+
+**Keywords:** 1-2 naturally integrated
+
+**Length:** Keep under 150 characters (mobile readability)
+
+## Content Optimization
+
+### Post Structure
+
+**Opening Line Critical:**
+- First 12-15 characters matter for discovery
+- Front-load keyword or hook
+- No wasted space
+
+**Example:**
+- ❌ "So I was thinking about..."
+- ✅ "Instagram SEO tip: keywords in Name field"
+
+### Thread Posts
+
+**When to Thread:**
+- Multi-part insights (3-5 posts)
+- Step-by-step guides
+- Story narratives
+
+**Structure:**
+1. Hook post (standalone value)
+2. Context/Setup
+3. Main content (1-2 posts)
+4. Conclusion + CTA
+
+**Note:** Threads algorithm rewards complete threads (read all posts)
+
+### Post Length
+
+**Optimal:** 100-200 characters
+- Scannable on mobile
+- Complete thought
+- Leaves room for engagement
+
+**Longer Acceptable:**
+- Educational content
+- Story-driven posts
+- Use line breaks for readability
+
+## Hashtag Strategy
+
+**Current State (Dec 2025):**
+- Hashtags less developed than Instagram/X
+- Follow hashtags not yet available
+- Limited discoverability via hashtags
+
+**Best Practice:**
+- 2-3 hashtags maximum
+- Niche-specific over broad
+- Topic-focused hashtags
+
+**Example:**
+```
+#CreatorEconomy #SocialMediaTips #ContentStrategy
+```
+
+**Don't:**
+- Copy Instagram's 30-hashtag lists
+- Use trending-only hashtags
+- Hashtag stuff
+
+## Cross-Platform Strategy
+
+### Instagram Synergy
+
+**Algorithm Connection:**
+- Meta recognizes related content across platforms
+- Similar topics on both → 2x discovery boost
+- Cross-posting can work if adapted
+
+**How to Leverage:**
+1. Post similar themes on both
+2. Adapt caption for each platform
+3. Share Threads posts to IG Stories
+4. Link IG posts in Threads when relevant
+
+**Example Flow:**
+```
+Instagram: Full caption + image + 5 hashtags
+Threads: Condensed version + link to IG post + discussion question
+```
+
+### Content Repurposing
+
+**From Instagram:**
+- Rewrite caption (shorter, conversation-starter)
+- Same topic, different angle
+- Ask for opinions/experiences
+
+**From X/Twitter:**
+- Threads = longer posts (can adapt thread)
+- Less emphasis on virality
+- More community discussion
+
+## Engagement Tactics
+
+### Conversation Over Likes
+
+**Algorithm Preference:**
+- Replies weighted heavily
+- Quality conversation > viral metrics
+- Genuine discussions boosted
+
+**Strategy:**
+- Ask open-ended questions
+- Reply to every comment (first hour)
+- Start conversations, not broadcasts
+
+### Reply Within 1 Hour
+
+**Why Critical:**
+- First hour sets engagement trajectory
+- Algorithm tests with small audience first
+- High early engagement → wider distribution
+
+**Action:**
+- Turn on post notifications
+- Reply thoughtfully (not just "thanks")
+- Ask follow-up questions
+
+### Community Building
+
+**Threads Rewards:**
+- Consistent engagement with specific accounts
+- Niche community participation
+- Quality over quantity followers
+
+**Build Community:**
+- Reply to others' posts in your niche
+- Share others' content (with credit)
+- Create discussion threads
+
+## Topic Clarity (Critical)
+
+### Last 9-12 Posts Matter
+
+**How Algorithm Works:**
+- Analyzes your recent posts (9-12)
+- Categorizes your account by topic
+- Suggests your content to interested users
+
+**Strategy:**
+- Stay focused on niche topics
+- Avoid random off-topic posts
+- Build topical authority
+
+**Example:**
+- ✅ All posts about social media SEO
+- ❌ Random mix: SEO, food photos, political opinions
+
+### Niche Consistency
+
+**Topic Authority:**
+- Post 80%+ in your primary niche
+- 20% can be related topics
+- Avoid complete topic jumps
+
+**Algorithm Benefit:**
+- Higher unconnected reach (discovery)
+- Recommended to similar interests
+- Profile appears in topic searches
+
+## Distribution System
+
+### Two-Tier Reach
+
+**Connected Reach (Your Followers):**
+- Relationship strength matters
+- Prior engagement history
+- Recent interaction patterns
+
+**Unconnected Reach (Discovery):**
+- Topic relevance
+- Freshness
+- Engagement velocity
+
+**Optimize Both:**
+- Engage with followers (connected)
+- Use keywords + hashtags (unconnected)
+
+### Boosting Unconnected Reach
+
+**Tactics:**
+1. Keyword-rich first line
+2. Topic consistency (9-12 posts)
+3. High early engagement
+4. Quality replies (not just likes)
+5. Cross-promotion from Instagram
+
+## What to Avoid
+
+❌ **Posting Off-Topic** - Confuses algorithm categorization
+❌ **Ignoring Replies** - Kills engagement signals
+❌ **Cross-Posting Verbatim** - Adapt for each platform
+❌ **Chasing Virality** - Threads rewards conversation
+❌ **Broadcasting Only** - Engage with community
+
+## Content Types That Work
+
+### Discussion Starters
+- Open-ended questions
+- "What's your experience with..."
+- Controversial (but respectful) takes
+
+### Educational Posts
+- Quick tips (1-2 sentences)
+- Mini-tutorials
+- Myth-busting
+
+### Personal Stories
+- Behind-the-scenes
+- Lessons learned
+- Vulnerability moments
+
+### Resource Shares
+- Tools
+- Articles
+- Other creators' content (with credit)
+
+## Analytics Tracking
+
+**Threads Insights:**
+- Views (reach metric)
+- Replies (engagement quality)
+- Reposts (share signal)
+- Quotes (engagement + reach)
+
+**Track:**
+1. Which topics get most replies?
+2. Best posting times for YOUR audience
+3. Engagement rate by post type
+4. Growth in unconnected reach
+
+## Future Features (Watch For)
+
+**Evolving Platform:**
+- DM functionality (rolled out partially)
+- Search improvements (ongoing)
+- Hashtag following (not yet available)
+- Algorithm refinements (frequent)
+
+**Stay Updated:**
+- Follow @mosseri (Adam Mosseri, Instagram head)
+- Test new features early
+- Adapt strategy as platform evolves
+
+## Integration with SEO Manager
+
+**Use Cases:**
+1. Adapt Instagram captions for Threads
+2. Query `databases/caption-styles.csv` filtered for conversation
+3. Cross-platform content calendar
+4. Track which topics work where
+
+**Workflow:**
+```
+1. Create Instagram post (optimized)
+2. Adapt for Threads (shorter, question-based)
+3. Post to both
+4. Track engagement patterns
+5. Iterate strategy
+```

package/skills/skills/social-media-seo/references/x-twitter-seo.md

@@ -0,0 +1,337 @@
+# X/Twitter SEO Playbook (2025)
+
+Complete guide for optimizing X/Twitter content for visibility, engagement, and discovery. Reflects November 2025 algorithm updates.
+
+## Critical Algorithm Understanding (2025)
+
+**How X Prioritizes Content:**
+1. **Recency** - Fresh content gets significant boost (24-48 hour window)
+2. **Engagement Quality** - Meaningful replies > retweets > likes
+3. **Account Authority** - Verification, follower quality, account history
+4. **First 100 Characters** - Critical for search ranking and categorization
+5. **Watch Time** (for videos) - Completion rate heavily weighted
+
+**Search Visibility:**
+- X has internal search (keyword-based)
+- Google indexes tweets (appears in SERPs for trending topics)
+- First 50-100 characters determine search ranking
+
+## Profile Optimization
+
+### Bio (160 Characters)
+
+**Formula:** `[Role/Expertise] helping [audience] [achieve result] • [proof element]`
+
+**Structure:**
+1. WHO you are (role + keyword)
+2. WHO you help (target audience)
+3. WHAT you deliver (value proposition)
+4. PROOF (social proof/credentials—optional)
+
+**Examples:**
+- "SEO strategist helping creators with discoverability • 100k+ followers grown • Thread master 🧵"
+- "Content marketing for B2B SaaS • Grew 50 companies to 7-figures • Tips daily"
+
+**Keywords:** Include 1-2 primary keywords naturally
+
+### Display Name
+
+**Options:**
+1. Name + Keyword: "Sarah Chen | SEO Expert"
+2. Name + Achievement: "John Smith • 100k Creator"
+3. Keyword-Rich: "SEO Tips Daily"
+
+**Searchable:** Display name is heavily weighted in X search
+
+### Username (@handle)
+
+**Best:** Include keyword if available (`@seotips`, `@contentgrowth`)
+**Reality:** Most keyword handles taken—prioritize brand consistency
+**SEO Value:** Moderate (less than display name or bio)
+
+### Profile Photo
+
+**Best Performers:** Clear face shots (human connection)
+**Branding:** Logos work if already known brand
+**Consistency:** Keep same photo (recognition builds trust)
+
+### Pinned Tweet
+
+**Strategic Use:**
+- Showcases best content (appears in Google for your brand)
+- Include call-to-action
+- Update monthly with top performer
+
+**Formula:** Hook + Value + CTA
+**Example:** "10 SEO tips that grew me to 100k. Bookmark this thread: [link]"
+
+## Tweet Optimization
+
+### First 100 Characters = Make or Break
+
+**Why Critical:**
+- X search algorithm prioritizes opening words
+- Google preview shows first ~100 characters
+- Users decide to engage in <3 seconds
+
+**Structure:**
+```
+[Hook/Keyword] [Value proposition] [Curiosity gap]
+```
+
+**Examples:**
+- ❌ "Hey everyone! I've been thinking about..."
+- ✅ "Twitter SEO tip that 10x'd my reach: Front-load keywords in first line."
+
+### Hook Formulas
+
+Use `databases/hook-formulas.csv` filtered for platform=twitter
+
+**Top Performers:**
+1. Bold claim + proof
+2. Data hook (I analyzed X...)
+3. Contrarian take
+4. Pattern recognition
+5. Personal failure story
+
+### Tweet Length
+
+**Optimal:** 120-150 characters
+- Leaves room for retweets with comments
+- Forces conciseness (higher engagement)
+
+**Longer Tweets:** Okay for value-dense content
+- Use line breaks for readability
+- Each paragraph = distinct point
+
+### Hashtag Strategy (IMPORTANT)
+
+**2025 Update:** X algorithm **penalizes 3+ hashtags**
+
+**Best Practice:**
+- 1-2 hashtags maximum
+- Place in first 50 characters (if using)
+- Trending hashtags > niche hashtags
+
+**Use Cases:**
+- 1 hashtag: Trending topic hijack
+- 2 hashtags: Category + niche
+- 0 hashtags: Often best (keywords > hashtags on X)
+
+**Reference:** `databases/hashtag-strategies.csv` platform=twitter
+
+## Thread Architecture
+
+### Why Threads Work
+- More space for keywords
+- Higher engagement rate
+- Better for complex topics
+- Searchable (thread compilation)
+
+### Thread Structure
+
+**Use:** `databases/thread-structures.csv`
+
+**Basic Formula:**
+1. **Hook tweet** (standalone + thread tease)
+2. **Context** (why this matters)
+3. **Value tweets** (7-9 tweets of core content)
+4. **Summary** (key takeaways)
+5. **CTA** (follow, bookmark, share)
+
+### First Tweet Optimization
+
+**Critical Elements:**
+1. Keyword in first 10 words
+2. Hook formula (curiosity/bold claim/data)
+3. Thread indicator (🧵 or "Thread:")
+4. Standalone value (works without thread)
+
+**Example:**
+```
+Twitter SEO changed in 2025. Here's what 1000 viral threads taught me: 🧵
+
+1. First 100 characters decide everything
+2. Hashtags now hurt reach (use 1-2 max)
+3. Engagement quality > quantity
+...
+```
+
+### Thread Length
+
+**Optimal:** 10-12 tweets
+- 1 hook
+- 7-9 value
+- 1 CTA
+
+**Avoid:** 20+ tweets (completion rate drops)
+
+## Content Types That Perform
+
+### Educational Threads
+- How-to guides
+- Frameworks/Templates
+- Tool recommendations
+- Case studies
+
+### Data-Driven Content
+- "I analyzed X..."
+- Research findings
+- A/B test results
+- Metrics/Stats
+
+### Personal Stories
+- Failure → Success
+- Behind-the-scenes
+- Controversial opinions
+- Lessons learned
+
+## Media Optimization
+
+### Images
+**Always Add Alt Text:**
+- Accessibility requirement
+- SEO benefit (indexed by search)
+- Formula: `[Keyword] + [detailed description]`
+
+**Example Alt Text:**
+```
+"Twitter SEO performance dashboard showing 300% engagement increase after implementing keyword optimization strategy"
+```
+
+### Videos
+**Best Length:** Under 30 seconds (completion rate critical)
+**Overlay Text:** Include keywords visible on screen
+**Captions:** Enable for accessibility + retention
+
+## Engagement Strategy
+
+### First Hour = 80% of Viral Potential
+
+**Actions:**
+1. Reply to every comment (within 60 min)
+2. Quote-tweet relevant content
+3. Tag relevant accounts (when appropriate)
+4. Retweet related threads
+
+### Reply SEO
+- Your replies appear in search
+- Include keywords in replies
+- Build conversation threads (boosts both tweets)
+
+### Quote Tweet Strategy
+- Add value, don't just agree
+- Use keywords in quote
+- Tag original author (notification → engagement)
+
+## What to Avoid
+
+❌ **3+ Hashtags** - Algorithm confirmed penalty
+❌ **Generic Engagement Bait** - "Like if you agree" hurts reach
+❌ **Link in First Tweet** - Reduces algorithmic distribution
+❌ **Keyword Stuffing** - Readability > SEO
+❌ **Auto-DM Spam** - Kills trust instantly
+
+## Posting Strategy
+
+### Timing
+**Best Practice:** Post when YOUR audience is active
+- Check X Analytics → Audience insights
+- Test different times for 30 days
+- First hour engagement = critical
+
+**General Guidelines:**
+- Weekdays: 8-10am, 12-1pm, 5-7pm (local time)
+- Weekends: 9am-12pm
+
+### Frequency
+**Quality > Quantity:**
+- 1-3 high-value tweets/day > 10 mediocre
+- Consistency matters more than volume
+- Thread 1-2x per week = optimal
+
+## Analytics to Track
+
+**X Analytics Dashboard:**
+1. **Impressions** - Reach metric
+2. **Engagement Rate** - Quality signal
+3. **Profile Visits** from tweets
+4. **Link Clicks** - If monetizing
+5. **Follower Growth** - Long-term metric
+
+**Track by Tweet Type:**
+- Which hooks perform best?
+- Thread topics with highest engagement?
+- Optimal posting times for you?
+
+**Iterate:** Double down on what works, cut what doesn't
+
+## Tools Integration
+
+**X Premium/Pro Features:**
+- Longer tweets (4000 chars)
+- Edit tweets (30 min window)
+- Analytics boost
+- Verification (credibility signal)
+
+**TweetDeck/XPro:**
+- Schedule tweets
+- Monitor mentions
+- Track keywords
+- Manage multiple accounts
+
+**Third-Party:**
+- Hypefury (auto-repost winners)
+- Typefully (thread composer)
+- Buffer/Hootsuite (scheduling)
+
+## Advanced Tactics
+
+### Thread Templates
+- Create reusable structures
+- Test and iterate frameworks
+- Save winners in `databases/thread-structures.csv`
+
+### Evergreen Threads
+- Pin to profile
+- Repost every 2-3 months
+- Update with fresh data
+
+### Cross-Promotion
+- Share threads on LinkedIn (repurpose)
+- Embed in blog posts
+- Newsletter feature
+
+### Collaboration
+- Guest threads on others' accounts
+- Round-up threads (tag multiple experts)
+- Twitter Spaces (voice + engagement)
+
+## Workflow Integration
+
+**Content Creation:**
+1. Research keywords → `databases/keyword-clusters.csv`
+2. Select thread structure → `databases/thread-structures.csv`
+3. Write hook → `databases/hook-formulas.csv`
+4. Optimize first 100 chars (keywords front-loaded)
+5. Add 1-2 hashtags (if relevant)
+6. Write alt text for images
+7. Schedule for optimal time
+8. Engage first hour
+
+**Iteration:**
+1. Track performance (X Analytics)
+2. Identify winners (engagement rate)
+3. Analyze why (hook? topic? timing?)
+4. Create variations
+5. Test and iterate
+
+## SEO Checklist (Per Tweet)
+
+- [ ] Keyword in first 100 characters?
+- [ ] Hook from proven formulas?
+- [ ] 1-2 hashtags max (or zero)?
+- [ ] Alt text on images?
+- [ ] Profile optimized?
+- [ ] Ready to engage first hour?
+- [ ] CTA included?