A trainable social media coaching system for Claude Code.
Finds winning topics, develops angles, generates hooks, learns from performance.
git clone https://github.com/charlesdove977/goviralbro.git && cd goviralbro && bash scripts/init-viral-command.shWorks on Mac, Windows (WSL), and Linux.
DISCOVER ──> ANGLE ──> SCRIPT ──> POST ──> ANALYZE
^ |
| |
└─── feedback loop (brain evolves) ───────────┘
| Stage | What Happens |
|---|---|
| Discover | Pull your competitors' winning content — see what got the most engagement, transcribe their videos, extract hook skeletons, and repurpose them in your voice. Currently supports YouTube + Instagram. More platforms coming. |
| Angle | Apply Contrast Formula to turn raw topics into format-specific angles (longform, shortform, LinkedIn) |
| Script | Generate hooks (6 patterns), full scripts (longform/shortform), filming cards, PDF lead magnets |
| Post | Post on your platforms after you've created your content |
| Analyze | Pull analytics, extract winners, identify patterns, auto-update brain and hook repository |
| Command | What It Does |
|---|---|
/viral:setup |
Platform connection wizard — dependency check, API config, verification |
/viral:onboard |
Interactive agent brain setup — ICP, pillars, platforms, competitors |
/viral:discover |
Topic discovery — competitor scrape, YouTube/Reddit/GitHub keyword search, or both |
/viral:angle |
Contrast Formula angle development — 5 angles per format (longform/shortform/LinkedIn) |
/viral:script |
Interactive script generator — pick format → pick angle → hooks + full script + PDF option |
/viral:analyze |
Multi-platform analytics + winner extraction + feedback loop |
/viral:update-brain |
Brain evolution protocol + insight aggregation |
- Agent brain that evolves from your performance data
- Competitor intelligence — pull their winning content, see engagement rankings, transcribe videos, extract hook skeletons, repurpose in your voice
- HookGenie engine — 6 hook patterns with composite scoring
- Format-based angles — 5 angles per format (longform, shortform, LinkedIn) = 15 takes per topic
- PDF lead magnet generation from any script
- Discovery: Competitor scraping (YouTube + Instagram) + keyword search (YouTube, Reddit, GitHub) — uses your brain's pillar keywords
- Monetization coaching baked into every output
goviralbro/
├── .claude/commands/ # 7 pipeline commands (viral-*.md)
├── data/ # JSONL data stores + agent brain
│ ├── agent-brain.json # Evolving system memory
│ ├── topics/ # Discovered topics
│ ├── angles.jsonl # Developed angles
│ ├── hooks.jsonl # Hook repository
│ ├── scripts.jsonl # Generated scripts
│ ├── analytics/ # Performance data
│ ├── insights/ # Aggregated patterns
│ └── cta-templates.json # CTA template library
├── schemas/ # JSON Schema draft-07 contracts
├── scripts/ # Bash + Python utilities (incl. generate-pdf.py)
├── recon/ # Competitor analysis module
├── scoring/ # Topic scoring engine
├── skills/last30days/ # Bundled discovery skill
└── docs/ # Cross-platform documentation
| Requirement | Version |
|---|---|
| Claude Code | Latest |
| Python | 3.10+ |
| Node.js | 18+ |
| OpenAI API key | — |
| YouTube Data API v3 key | — |
Optional: Instaloader (Instagram scraping), yt-dlp (YouTube transcripts).
See SETUP.md for detailed installation and platform connection guides.
See CONTRIBUTING.md for guidelines.
MIT — see LICENSE.
Built by Charles Dove · YouTube · Skool Community