phy041/composite/content-flywheel

Content Flywheel — Composite Skill

Orchestrates the full build-in-public content cycle. Single command drives the entire loop.

Architecture

ship-digest          → Detects new GitHub repos
    ↓
founder-content      → Generates platform-native drafts
    ↓ (parallel)
social-post          → Posts to Twitter + LinkedIn
reddit-cultivate     → Posts to Reddit (if applicable)
    ↓
engagement-tracker   → Pulls metrics 24h after posting
    ↓ (conditional)
content-multiply     → Repurposes winners (if threshold crossed)
    ↓
xhs-image-gen        → Generates XHS carousels (if XHS in targets)

Feedback Loops

1. Quality Gate: founder-content runs STEPPS scoring (≥40/60 to proceed). If score < 40, skill loops back and enriches the content angle before posting.

2. Winner Detection: engagement-tracker feeds results to content-multiply. Only posts crossing engagement thresholds (configurable) trigger repurposing.

3. Platform Learning: Tracks which subreddits / target accounts yield best engagement. Updates platform targeting weights over time (stored in memory/flywheel-state.json).

Step-by-Step Execution

Phase 1: Detect (ship-digest)

Call ship-digest skill with github_username.

Input → github_username
Output → list of new repos with descriptions + commit summaries

If no new repos: check memory/YYYY-MM-DD.md for any manually queued content ideas. If nothing: exit with FLYWHEEL_IDLE.

Phase 2: Generate (founder-content)

For each new repo / content idea, call founder-content skill.

Input → repo description + README summary
Output → platform drafts: {twitter: "...", linkedin: "...", reddit: "..."}

Run STEPPS quality check. If any platform draft scores < 40/60:

• Identify weak dimensions
• Enrich content angle (add specifics, data, story arc)
• Regenerate that platform's draft

Phase 3: Distribute (social-post + reddit-cultivate) [PARALLEL]

Simultaneously:

Twitter/LinkedIn: Call social-post skill
Input → content (founder-content output for platform), platforms list
Output → post_ids, URLs

Reddit: Call reddit-cultivate skill if topic fits a relevant subreddit
Input → content (reddit-adapted draft), target subreddits
Output → comment URLs, quality scores

Log all posted URLs to memory/YYYY-MM-DD.md in standard table format.

Phase 4: Measure (engagement-tracker) [RUNS 24H LATER]

Triggered by cron 24h after Phase 3.

Input → yesterday's posted URLs (from daily memory log)
Output → metrics per post {platform, url, upvotes/likes/views, replies}

Phase 5: Multiply (content-multiply) [CONDITIONAL]

Only runs if Phase 4 finds posts crossing engagement thresholds.

Input → engagement data from Phase 4
Output → derivative drafts {platform, content, suggested_date}

If XHS is in target platforms and winner has 3+ slides worth of content:

• Generate content JSON structure
• Call xhs-image-gen to produce carousel images
• Queue for manual upload

Phase 6: Report

Send summary to user:

🔄 Content Flywheel — [date]

Phase 1 (Detect): [N] new repos / content ideas
Phase 2 (Generate): [N] drafts created, avg STEPPS score [X]/60
Phase 3 (Distribute): Posted to [platforms] — [URLs]
Phase 4 (Measure): Best performer: [platform] [X upvotes/likes]
Phase 5 (Multiply): [N] derivatives queued / IDLE (no winners yet)

Next cycle: [scheduled time]

State File

memory/flywheel-state.json:

{
  "last_run": "ISO8601",
  "platform_weights": {
    "reddit": {"r/ClaudeAI": 0.8, "r/SideProject": 0.4},
    "twitter_targets": ["levelsio", "paulg", "dickiebush"]
  },
  "pending_engagement_checks": [
    {"url": "https://...", "posted_at": "ISO8601", "check_due": "ISO8601"}
  ],
  "repurpose_queue": []
}

I/O Contract Summary

| Phase | Skill Called | Key Input | Key Output | |-------|-------------|-----------|------------| | 1 | ship-digest | github_username | new_repos list | | 2 | founder-content | repo description | platform drafts | | 3a | social-post | drafts, platforms | post URLs | | 3b | reddit-cultivate | reddit draft, subreddits | comment URLs | | 4 | engagement-tracker | posted URLs (from memory) | metrics json | | 5 | content-multiply | metrics json | derivative drafts | | 5b | xhs-image-gen | slides json | image files |

Configuration

All thresholds configurable in memory/flywheel-state.json:

• quality_gate_threshold: minimum STEPPS score to post (default: 40/60)
• engagement_threshold_reddit: upvotes to trigger multiplication (default: 15)
• engagement_threshold_twitter: likes to trigger multiplication (default: 5)
• target_platforms: list of active platforms