{
  "markdown": "# Claude Cowork - Head of Content\n> Your AI-powered content research coworker. Stop guessing what content works—let Claude research, analyze, and surface winning patterns across X/Twitter, Instagram, YouTube, and TikTok.\n>\n> Check out this [YouTube video](https://www.youtube.com/@bradbonanno) where we walk through setting up and using Head of Content.\n\n<img src=\"images/claude-cowork.png\" alt=\"Head of Content - Claude Cowork\" width=\"800\">\n\nA [Claude Cowork](https://docs.anthropic.com/en/docs/claude-code/claude-cowork) skill set that automates social media content research—identifying high-performing content, analyzing viral patterns with AI, and generating actionable content strategies.\n\n## Get Your API Keys\n\n| Service | What It Powers | Sign Up |\n|---------|----------------|---------|\n| **Apify** | X/Twitter, Instagram, TikTok scraping | [Sign up for Apify](https://console.apify.com/?fpr=ih20xe) |\n| **TubeLab** | YouTube outlier detection | [Sign up for TubeLab](https://tubelab.net/?ref=brad) |\n\n## What This Does\n\n- **Research high-performing content** across 4 major platforms\n- **Identify statistical outliers** using engagement scoring algorithms\n- **Analyze videos with AI** to extract hooks, structure, and replicable patterns\n- **Generate content plans** with cross-platform opportunity scoring\n- **Create platform playbooks** with specific recommendations\n\n## Prerequisites\n\n- **macOS** (required for Claude CoWork)\n- **Claude Max Plan** (required for custom skills)\n- **Claude Desktop** installed\n- **Python 3.8+** with pip\n\n---\n\n## Quick Start\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/bradautomates/head-of-content.git\ncd head-of-content\n```\n\n### 2. Set Up Your Environment\n\nCopy the example environment file and add your API keys (see [API Keys Setup](#api-keys-setup) below):\n\n```bash\ncp .env.example .env\n```\n\nThen edit `.env` with your API keys.\n\n### 3. Open in Claude Desktop\n\n1. Open **Claude Desktop**\n2. Click the **Claude Coworker** tab the in sidebar\n3. At the bottom of the panel, click **Work in a folder**\n4. Select your `head-of-content` folder\n\n### 4. Install the Skills\n\nThe repository includes 6 `.skill` files that need to be added to Claude Desktop:\n\n1. In Claude Desktop, go to **Settings** (gear icon)\n2. Click **Capabilities**\n3. Click **Skills**\n4. Click **Add Skill**\n5. Upload each `.skill` file from your `head-of-content` folder:\n   - `x-research.skill`\n   - `instagram-research.skill`\n   - `youtube-research.skill`\n   - `tiktok-research.skill`\n   - `video-content-analyzer.skill`\n   - `content-planner.skill`\n\nRepeat the \"Add Skill\" process for each file.\n\n---\n\n## API Keys Setup\n\nThis repository requires 3 API keys.\n\n### Apify (X/Twitter, Instagram, TikTok)\n\nApify powers the social media scraping for X, Instagram, and TikTok.\n\n**Actors used:**\n- [Tweet Scraper V2](https://apify.com/apidojo/tweet-scraper?fpr=ih20xe) - X/Twitter posts and profiles\n- [Instagram Scraper](https://apify.com/apify/instagram-scraper?fpr=ih20xe) - Instagram posts and reels\n- [TikTok Scraper](https://apify.com/clockworks/tiktok-scraper?fpr=ih20xe) - TikTok videos and profiles\n\n**Setup:**\n1. Go to [console.apify.com](https://console.apify.com/?fpr=ih20xe)\n2. Click **Sign Up** (A paid subscription is required for the X scraper to function as expected)\n3. After signing in, go to **Settings** > **Integrations**\n4. Copy your **Personal API Token**\n\n**Cost:** Free tier includes $5/month. Research runs typically cost $0.10-$0.50 depending on volume.\n\n### TubeLab (YouTube)\n\nTubeLab provides YouTube outlier detection and video intelligence.\n\n**APIs used:**\n- [Outliers API](https://tubelab.net/docs/api/reference/search-outliers?ref=brad) - Find viral videos in any niche\n- [Transcripts API](https://tubelab.net/docs/api/reference/get-video-transcript?ref=brad) - Get video transcripts\n\n**Setup:**\n1. Go to [tubelab.net](https://tubelab.net/?ref=brad)\n2. Click **Sign Up** and create an account\n3. Go to **Settings** > **API** (or visit [tubelab.net/settings/api](https://tubelab.net/settings/api?ref=brad))\n4. Generate and copy your **API Key**\n\n**Cost:** Free tier available. Paid plans start at ~$29/month for higher limits.\n\n### Google Gemini (Video Analysis)\n\nGemini AI analyzes video content to extract hooks, patterns, and structure.\n\n1. Go to [aistudio.google.com](https://aistudio.google.com/)\n2. Sign in with your Google account\n3. Click **Get API Key** (or visit [aistudio.google.com/apikey](https://aistudio.google.com/apikey))\n4. Click **Create API Key** and copy it\n\n**Cost:** Free tier includes 60 requests/minute. More than enough for research.\n\n---\n\n## Environment Setup\n\n### Create Your .env File\n\nCopy the example environment file:\n\n```bash\ncp .env.example .env\n```\n\nOpen `.env` in your editor and add your API keys:\n\n```bash\n# YouTube Research - TubeLab API\nTUBELAB_API_KEY=your-tubelab-api-key-here\n\n# X/Twitter, Instagram, TikTok Research - Apify API\nAPIFY_TOKEN=your-apify-token-here\n\n# Video Analysis - Gemini API\nGEMINI_API_KEY=your-gemini-api-key-here\n```\n\n### Verify Setup\n\nTest that your environment is configured correctly:\n\n```bash\n# Load environment variables\nexport $(cat .env | grep -v '^#' | xargs)\n\n# Verify they're set\necho \"Apify: ${APIFY_TOKEN:0:10}...\"\necho \"TubeLab: ${TUBELAB_API_KEY:0:10}...\"\necho \"Gemini: ${GEMINI_API_KEY:0:10}...\"\n```\n\n---\n\n## Configure Your Research Targets\n\nBefore running research, configure which accounts to track in `.claude/context/`:\n\n### X/Twitter Accounts\n\nEdit `.claude/context/x-accounts.md`:\n\n```markdown\n# X/Twitter Accounts to Track\n\n| Username | Niche | Notes |\n|----------|-------|-------|\n| @levelsio | indie hacking | bootstrapped founder, viral tweets |\n| @naval | philosophy/startups | high engagement threads |\n| @sahaborhani | AI/tech | technical content |\n```\n\n### Instagram Accounts\n\nEdit `.claude/context/instagram-accounts.md`:\n\n```markdown\n# Instagram Accounts to Track\n\n| Username | Niche | Notes |\n|----------|-------|-------|\n| @garyvee | marketing | high volume, reels focus |\n| @hormozi | business | educational content |\n```\n\n### TikTok Accounts\n\nEdit `.claude/context/tiktok-accounts.md`:\n\n```markdown\n# TikTok Accounts to Track\n\n| Username | Niche | Notes |\n|----------|-------|-------|\n| @garyvee | marketing | cross-platform content |\n| @tiktokcreators | meta/tips | platform trends |\n```\n\n### YouTube Channel (Your Channel)\n\nEdit `.claude/context/youtube-channel.md` with your channel info:\n\n```markdown\n# YouTube Channel Context\n\n## Channel Information\n- **Channel Name:** Your Channel Name\n- **Channel Handle:** @yourhandle\n- **Channel ID:** UCxxxxxxxxxxxxxxxxxx\n\n## Niche & Positioning\n- **Primary Niche:** Your niche\n- **Content Style:** Your style\n- **Target Audience:** Your audience\n\n## Content Strategy\n- **Typical Video Length:** 10-20mins\n- **Upload Frequency:** Weekly\n- **Best Performing Topics:** Your best topics\n\n## Goals\n- **Growth Targets:** Your subscriber goal\n- **Content Goals:** Your content goals\n```\n---\n\n## Available Skills\n\nOnce connected, these skills are available in Claude Desktop:\n\n| Command | Description |\n|---------|-------------|\n| `/x-research` | Research X/Twitter content |\n| `/instagram-research` | Research Instagram reels and posts |\n| `/youtube-research` | Find YouTube outliers in your niche |\n| `/tiktok-research` | Research TikTok videos |\n| `/content-planner` | Run all research + create content plan |\n\nType `/` in the chat to see all available skills.\n\n---\n\n## Usage\n\n### Run Individual Platform Research\n\nIn Claude Desktop, simply invoke the skill:\n\n```\nRun x-research\n```\n\nThis will:\n1. Fetch recent content from your tracked accounts\n2. Calculate engagement scores and identify outliers\n3. Analyze top videos with AI (if applicable)\n4. Generate a report in `x-research/YYYY-MM-DD_HHMMSS/`\n\n### Run Full Content Planning\n\nFor comprehensive cross-platform research:\n\n```\nRun content-planner\n```\n\nThis will:\n1. Run all 4 platform research skills in parallel\n2. Aggregate findings across platforms\n3. Identify cross-platform content opportunities\n4. Generate platform-specific playbooks\n5. Output everything to `content-plans/YYYY-MM-DD_HHMMSS/`\n\n### Natural Language\n\nYou can also just ask Claude:\n\n- \"Research what's performing on X right now\"\n- \"Find trending content in my Instagram niche\"\n- \"Create a content plan for next week\"\n- \"What videos are going viral on TikTok?\"\n\n---\n\n## Output Structure\n\n### Platform Research Output\n\nEach research run creates a timestamped folder:\n\n```\nx-research/2024-01-15_143022/\n├── raw.json            # Raw API data\n├── outliers.json       # Identified outliers with metrics\n├── video-analysis.json # AI-extracted patterns (if videos)\n└── report.md           # Human-readable summary\n```\n\n### Content Plan Output\n\n```\ncontent-plans/2024-01-15_143022/\n├── content-ideas.md       # Cross-platform content opportunities\n├── x-playbook.md          # X/Twitter specific intelligence\n├── instagram-playbook.md  # Instagram specific intelligence\n├── youtube-playbook.md    # YouTube specific intelligence\n└── tiktok-playbook.md     # TikTok specific intelligence\n```\n\n---\n\n## Engagement Scoring\n\nEach platform uses optimized engagement weights:\n\n### X/Twitter\n| Signal | Weight | Why |\n|--------|--------|-----|\n| Bookmarks | 4x | Strongest intent signal |\n| Replies | 3x | Conversation starter |\n| Retweets | 2x | Amplification |\n| Quotes | 2x | Commentary |\n| Likes | 1x | Passive approval |\n\n### Instagram\n```\nengagement = likes + (3 × comments) + (0.1 × views)\n```\n\n### TikTok\n```\nengagement = likes + (3 × comments) + (2 × shares) + (2 × saves) + (0.05 × views)\n```\n\n### YouTube\n```\nscore = zScore × recency_boost  (5% daily decay)\n```\n\n**Outlier threshold:** Content scoring above `mean + (2.0 × std_dev)` is flagged as an outlier.\n\n---\n\n## Troubleshooting\n\n### \"API key not found\" errors\n\n```bash\n# Make sure .env exists and has your keys\ncat .env\n\n# Load environment variables before running\nexport $(cat .env | grep -v '^#' | xargs)\n```\n\n### \"No accounts configured\" warnings\n\nMake sure you've added accounts to track in `.claude/context/`:\n- `x-accounts.md`\n- `instagram-accounts.md`\n- `tiktok-accounts.md`\n\n### Cowork not showing in Claude Desktop\n\n1. Verify you're on the **Claude Max plan**\n2. Update and restart Claude Desktop\n\n### Apify rate limits\n\nThe free Apify tier has usage limits. If you hit them:\n- Reduce the number of accounts tracked\n- Increase time between research runs\n- Consider upgrading your Apify plan\n\n---\n\n## License\n\nMIT License - Feel free to modify and distribute.\n\n---\n\n## Contributing\n\nContributions welcome! To add new skills or improve existing ones:\n\n1. Fork the repository\n2. Use `/skill-creator` to scaffold new skills\n3. Follow the patterns in existing skills\n4. Submit a pull request\n\n---\n\n## Implement AI in Your Business\n> Practical AI implementation for real business results\n\nLearn how to implement AI tools and workflows that actually move the needle for your business on my [YouTube channel](https://www.youtube.com/@bradbonanno).\n\nFollow [@corpcowboy_](https://x.com/corpcowboy_) on X",
  "bytes": 11082,
  "sha": "67374d5ed867808d0ee9100261f765a7d7ba1fb5f670df0b38cf38f413faac93",
  "repo_slug": "bradautomates/head-of-content",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_bradautomates_head_of_content_tiktok_res_9d970f00/readme"
}