Threads Growth Skill

reason-machines/marketing-skills/skills/threads-growth-skill

by reason-machines97301f4188a7152bed5a121cbd4763ba9ac21afeNo licenseListed Oct 9, 2026Updated Oct 9, 2026

Systematically improve Threads content using real performance data and algorithm-aware drafting

Instructions onlyMarketing & SalesData & Analytics
AI-generated overview

Optimizes Threads posts using scraped account performance data, algorithm rules, and AI-tone checks.

What it does
This skill tracks a Threads account's real post performance, detects which content patterns work for that account, and drafts new posts following those patterns. It checks drafts against algorithm suppression rules and flags common AI writing tells, then returns a predictive score covering DM forwardability, repost likelihood, compliance, and estimated reach. It also describes multi-part post chaining and a bi-weekly data refresh.
When to use it
Use it when drafting Threads posts, analyzing your own Threads performance, or scoring a draft before publishing. It is aimed at creators who want content decisions based on their own account data rather than generic advice.
Requirements
Requires a Threads account, exported session cookies saved as cookies.json, and the THREADS_USERNAME environment variable. The document describes setup and scraper shell scripts and a bi-weekly cron job, but the skill ships instructions only, with no scripts or assets included.

Threads Growth Skill

Skill by ara.so — Marketing Skills collection.

Data-driven Threads content optimization that learns from your actual post performance. Uses browser automation to scrape Insights, identifies winning patterns, and drafts algorithm-compliant posts with AI-tone detection.

What this does

  • Performance tracking: Scrapes your real Threads Insights (views, likes, replies, shares)
  • Pattern detection: Identifies what works for YOUR account (not generic advice)
  • Smart drafting: Creates posts using your patterns + algorithm red-line checks + AI-tone detection
  • Automated updates: Bi-weekly cron keeps your performance database current
  • Share optimization: Prioritizes DM forwardability (3-5x weight vs likes per Mosseri 2025)

Installation

bash
# Clone into Hermes skills directorygit clone https://github.com/krumjahn/threads-growth-skill ~/.hermes/skills/social-media/threads-growth
# OR create directory structure manuallymkdir -p ~/.hermes/skills/social-media/threads-growth/{references,scripts}

First-time setup

1. Export Threads cookies

Required for authentication (cookies last ~60 days):

bash
# Install Cookie-Editor browser extension# Navigate to threads.net (logged in)# Export cookies as JSON# Save to ~/.hermes/skills/social-media/threads-growth/cookies.json

2. Run setup script

bash
cd ~/.hermes/skills/social-media/threads-growthbash scripts/setup.sh

This will:

  • Validate cookie format
  • Test authentication
  • Run first Insights scrape (~5 min)
  • Create references/winning-formats.md
  • Set up bi-weekly cron job

3. Configure environment

bash
# Set your Threads usernameexport THREADS_USERNAME="your_username"
# Optional: Custom data pathexport THREADS_DATA_PATH="$HOME/.hermes/skills/social-media/threads-growth"

Key files

threads-growth/├── SKILL.md                        # This file├── cookies.json                    # Your session cookies (gitignored)├── references/│   └── winning-formats.md          # Performance database (auto-updated)└── scripts/    ├── setup.sh                    # One-time setup    └── scrape_insights.sh          # Insights scraper

Core workflows

Draft a new post

bash
# User says: "draft a threads post about [topic]"# Skill loads winning-formats.md# Generates draft following your patterns# Runs algorithm + AI-tone checks# Returns scored draft

Example pattern matching:

markdown
# From winning-formats.md (auto-generated)Top format: Anti-Demo Hook + Problem/Solution + ProofAvg engagement: 2,340 views, 186 likes, 23 replies, 12 shares
Structure:1. Failure state (specific)2. What you discovered3. How to implement (3-5 steps)4. Proof/result (concrete metric)
Best performing: Posts with DM-forwardable utility (how-to, tool lists, templates)

Algorithm red-line check

12 hard suppression rules from Meta's 2025 guidelines:

bash
# Automatically checked in every draft:# 1. No external links in first post (only replies OK)# 2. No bare URLs (use "link in bio" instead)# 3. No follower begging ("follow me", "help me hit X followers")# 4. No engagement bait ("comment if you agree", "double tap")# 5. No fake news/misinformation signals# 6. No sensationalized language (all caps, excessive punctuation)# 7. No violent/graphic imagery# 8. No sexual content# 9. No hate speech# 10. No spam patterns (repetitive, copy-paste)# 11. No impersonation# 12. No coordinated manipulation

AI-tone detection

Flags and fixes 15 common AI tells before posting:

bash
# Sentence-level tells:- "Delve", "utilize", "leverage" → Replace with plain language- "It's worth noting that" → Cut- "In today's digital landscape" → Cut or rephrase- "Game-changer", "unlock" → Use concrete verbs- Passive voice → Convert to active
# Structure-level tells:- Lists starting "1. First..." → Vary openings- Three parallel paragraphs → Break rhythm- Summary ending "In conclusion..." → Cut- Overly balanced pros/cons → Take a stance- Academic hedging ("perhaps", "somewhat") → Be direct

Score a draft

bash
# Before publishing, get predictive score:# - DM forwardability (0-10)# - Repost likelihood (0-10)# - Algorithm compliance (pass/fail)# - AI-tone flags (count)# - Estimated reach multiplier (vs your baseline)

Insights scraper

Manual run

bash
cd ~/.hermes/skills/social-media/threads-growthbash scripts/scrape_insights.sh

What it collects

bash
# For each post (last 50):- Post ID- Publish timestamp- Text content- Views (reach)- Likes- Replies (total + depth)- Shares (DM forwards + reposts)- Save count

Auto-update cron

bash
# Installed during setup:# Runs every 2 weeks (Sunday 2 AM)0 2 * * 0 [ $(($(date +\%s) / 604800 \% 2)) -eq 0 ] && bash ~/.hermes/skills/social-media/threads-growth/scripts/scrape_insights.sh

Hook framework

Built-in post structures ranked by performance:

Hook TypeUse CaseAvg. Multiplier
Anti-DemoYou hit failure → found fix1.5x
Secret KnowledgeInsider info + steps1.4x
Truth/ComparisonA vs B, clear winner1.2x
Builder JourneyWorkflow switch + results1.1x
Link DropJust a link0.2x (avoid)

Anti-Demo example structure

markdown
I wasted 6 weeks posting at "optimal times"(my reach actually dropped 40%)
Then I found this:
Threads doesn't care about your timezone.It cares about YOUR audience's active hours.
How to find them:1. Export your Insights (this skill does it)2. Map reply times (not post times)3. Post 1 hour before peak reply window4. Track for 2 weeks
My reach jumped 2.3x in 10 days.Same content. Better timing.

Signal weighting

Based on Mosseri 2025 algorithm updates:

bash
# DM forwards: 3-5x weight of likes# Deep replies (3+ back-and-forth): 2x weight of top-level# Saves: 2x weight of likes# Reposts: 1.5x weight of likes# Likes: 1x baseline# Views: Outcome, not signal

Optimization priority:

  1. DM forwardability (utility, tools, templates)
  2. Conversation depth (ask questions, provide incomplete info)
  3. Save-worthiness (reference value)
  4. Repost-ability (identity signal for sharer)
  5. Likability (lowest priority)

Multi-part Threads

For posts >500 chars:

bash
# Skill automatically chains parts# Each part: 450-500 chars (leaves buffer)# Structure:# Part 1: Hook + problem# Part 2-N: Steps/details# Final part: Proof/CTA
# Algorithm treats as one post if:# - Published within 60 seconds# - No external engagement between parts# - Same thread chain

Configuration options

bash
# Environment variables (optional)export THREADS_USERNAME="your_username"          # Requiredexport THREADS_DATA_PATH="$HOME/.hermes/..."    # Default shownexport THREADS_SCRAPE_LIMIT=50                   # Posts to fetch (default 50)export THREADS_MIN_PERFORMANCE_SAMPLE=10         # Min posts for pattern detectionexport THREADS_COOKIE_WARNING_DAYS=7             # Days before expiry to warn

Troubleshooting

Cookie expiry

bash
# Symptoms: Scraper fails with 401/403# Fix: Re-export cookies from browser# 1. Login to threads.net# 2. Export cookies (Cookie-Editor)# 3. Save to cookies.json# 4. Run: bash scripts/scrape_insights.sh

Missing Insights data

bash
# Threads only shows Insights for posts with 100+ views# For new accounts: Wait until you have 10+ qualifying posts# Check: references/winning-formats.md for sample size
# If sample size < 10:# - Patterns unreliable# - Skill uses general best practices until enough data

Scraper hanging

bash
# Usually: Slow network or Threads rate limiting# Fix 1: Kill process, wait 5 min, retry# Fix 2: Reduce THREADS_SCRAPE_LIMIT to 25
pkill -f scrape_insightssleep 300bash scripts/scrape_insights.sh

Pattern detection not working

bash
# Need minimum viable sample:# - 10+ posts with Insights# - At least 5 with 500+ views# - Published over 2+ weeks
# Check your data:cat references/winning-formats.md | grep "Sample size"

Algorithm knowledge base

Adapted from AK-Threads-Booster:

Boost signals

  • Original thinking (not reposted content)
  • Conversation starters (questions, incomplete info)
  • DM-forwardable utility
  • Identity-signal repostability
  • Consistent posting (3-5x/week better than daily)

Suppression signals

  • External links in main post
  • Engagement bait
  • Follower begging
  • Repetitive content
  • Low reply rate (<2%)

Timing myths

  • "Post at 9 AM" → Wrong. Post 1hr before YOUR audience's active window
  • "Post daily" → Wrong. 3-5x/week with high quality beats daily low quality
  • "First hour decides reach" → Partially true. First 3 hours matter most.

Example: Complete workflow

bash
# 1. User requests"Draft a threads post about my new AI coding workflow"
# 2. Skill loads patternscat references/winning-formats.md# Identifies: Anti-Demo hook + 3-step process performs best for you
# 3. Generates draftI tried using ChatGPT for code review.It missed 3 critical bugs in production code.
Switched to Claude + this prompt structure:1. Show the code2. Ask "what breaks first?"3. Request refactor with error handling
Caught 12 issues ChatGPT missed.Same AI. Better questions.
# 4. Runs checks✓ Algorithm compliance (no red-line violations)✓ AI-tone scan (0 flags)✓ DM forwardability: 8/10 (actionable steps)✓ Estimated reach: 1.4x your baseline
# 5. User approves and posts

Data privacy

  • All data stored locally (~/.hermes/skills/social-media/threads-growth)
  • Cookies never transmitted (used only for Threads authentication)
  • Insights data never shared
  • No tracking, no analytics

Performance baseline

Typical results after 6 weeks:

  • 1.5-2.5x reach improvement
  • 2-3x engagement rate increase
  • 40-60% reduction in low-performing posts
  • Better pattern recognition every 2-week cycle

Updates

bash
# Pull latest versioncd ~/.hermes/skills/social-media/threads-growthgit pull origin main
# Refresh patterns (optional)bash scripts/scrape_insights.sh

Built by @krumjahn — Running live since April 2026. MIT License.

Source and attribution

Source:reason-machines/marketing-skillsinskills/threads-growth-skillat commit97301f4

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from reason-machines/marketing-skills

Seo Geo Claude Skills

reason-machines

A library of 20 SEO and GEO skills for keyword research, content optimization, technical audits, and rank tracking.

Marketing & SalesOct 9, 2026

Seo Content Marketing Skills Suite

reason-machines

SEO and content marketing command suite covering keyword research, content audits, technical SEO, competitor gaps, and content strategy.

Marketing & SalesOct 9, 2026

Seo Content Marketing Skill Suite Claude

reason-machines

An SEO and content marketing command suite covering keyword research, content audits, technical SEO, competitor gaps and content planning.

Marketing & SalesOct 9, 2026

Seo Content Marketing Skill Factory

reason-machines

Provides SEO and content marketing commands for keyword research, audits, SERP tracking, and content planning.

Marketing & SalesOct 9, 2026

Seo Content Marketing Command Suite

reason-machines

Provides SEO and content marketing commands for keyword research, audits, competitor gaps, and content planning.

Marketing & SalesOct 9, 2026

Seo Content Marketing Claude Skill Suite

reason-machines

A suite of SEO and content marketing commands for keyword research, audits, technical SEO, and SERP analysis.

Marketing & SalesOct 9, 2026

More in Marketing & Sales

Deal Sourcing

anthropics

Featured

Guides a private equity deal sourcing pipeline: find target companies, check CRM history, and draft founder outreach emails.

Marketing & Sales39Kupdated 2 weeks ago

Investment Proposal

anthropics

Featured

Guides creation of personalized investment proposals for prospective advisory clients, from discovery through slide deck, PDF, and summary.

Marketing & Sales39Kupdated 2 weeks ago

Lead Triage

anthropics

Featured

Scores inbound HubSpot leads, ranks a call list with talking points, drafts follow-ups and proposes calendar slots.

Marketing & Sales27Kupdated today

Prospect

anthropics

Featured

Builds targeted account and contact prospect lists using Common Room's Prospector, with iterative refinement and web enrichment.

Marketing & Sales27Kupdated today

Account Research

anthropics

Featured

Builds a sourced research brief on a prospect company and optional contact, checks CRM ownership, and scores ICP fit.

Marketing & Sales27Kupdated today

Content Strategy

anthropics

Featured

Turns PayPal, QuickBooks or Square sales data into a prioritized 30-day content brief for small businesses.

Marketing & Sales27Kupdated today