Skip to main content
skill CX Codex

content-planner — Claude Code skill: multi-platform research and content plan

content-planner — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that spins up parallel subagents to research X, Instagram, YouTube, and TikTok at once.

MIT 297 installs ★ 333 updated 2026-01-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add bradautomates/head-of-content --skill content-planner -a claude-code
Open on GitHub

What content-planner does

On activation it creates a timestamped folder under content-plans/, then fires four subagents simultaneously — one per platform. Each pulls posts from the past 30 days (up to 100 tweets, up to 50 reels, up to 50 TikTok videos per account), scores engagement outliers, and returns a JSON summary with run folder, post counts, and top keywords.

The orchestrator reads outliers.json and video-analysis.json from each platform's run folder, normalises keywords, finds cross-platform intersections, and calculates an opportunity_score for X-sourced ideas: (x_engagement × 1.5) / (instagram_saturation + youtube_saturation + tiktok_saturation + 1). Output is content-ideas.md with a two-week calendar and four playbooks — x-playbook.md, instagram-playbook.md, youtube-playbook.md, tiktok-playbook.md — each containing replicable hook formulas, format patterns, and the top 15 outliers.

Three environment variables must be present in .env: APIFY_TOKEN for X, Instagram, and TikTok; TUBELAB_API_KEY for YouTube; GEMINI_API_KEY for video analysis. Target accounts are configured via files in .claude/context/. Each subagent loads the .env before any API call — missing variables stop the run at the API step, not at startup.

What it helps with

  • run parallel research across X, Instagram, YouTube, and TikTok in a single command
  • find topics with high engagement that haven't saturated other platforms yet
  • build a two-week content calendar from real engagement data
  • generate per-platform playbooks with hook formulas and format breakdowns
  • aggregate outputs from four subagents into one structured report

Example prompts for the agent

  • Build a content plan using accounts from .claude/context/
  • Run comprehensive research across all platforms and generate playbooks
  • Aggregate content ideas from X, Instagram, YouTube, and TikTok into a strategy

How to install content-planner

1Skills CLI (Vercel)

npx skills add bradautomates/head-of-content --skill content-planner -a claude-code

2Manually: put the files in place

~/.claude/skills/content-planner/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/content-planner/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about content-planner

How do I install content-planner in Claude Code?

Run npx skills add bradautomates/head-of-content --skill content-planner -a claude-code. The skill file will then be available at ~/.claude/skills/content-planner/SKILL.md.

What does the content-planner skill do?

It launches four subagents in parallel, one per platform, then aggregates the results into a cross-platform content-ideas.md and four platform playbooks saved under content-plans/.

What API keys does content-planner require?

Three variables in .env: APIFY_TOKEN for X, Instagram, and TikTok; TUBELAB_API_KEY for YouTube; GEMINI_API_KEY for video analysis. Each subagent loads them before making any API call.

Source text

SKILL.md · MIT
---
name: content-planner
description: |
  Orchestrate comprehensive content research across X, Instagram, YouTube, and TikTok platforms.
  Runs all research skills in parallel via subagents, then aggregates findings into
  actionable content plans and platform-specific intelligence playbooks.

  Use when asked to:
  - Create a content plan for social media
  - Research content across all platforms
  - Generate content ideas from multiple sources
  - Build a content strategy playbook
  - Aggregate research from X, Instagram, YouTube, TikTok
  - Run comprehensive content research
  - Create platform playbooks

  Triggers: "content plan", "content planner", "research all platforms",
  "comprehensive research", "content strategy", "multi-platform research",
  "create playbooks", "aggregate research"
---

# Content Planner

Orchestrate parallel research across X, Instagram, YouTube, and TikTok, then aggregate findings into content ideas and platform-specific playbooks.

## Prerequisites

Same as individual research skills:
- `APIFY_TOKEN` for X, Instagram, and TikTok research
- `TUBELAB_API_KEY` for YouTube research
- `GEMINI_API_KEY` for video analysis
- Accounts configured in `.claude/context/` for each platform

**CRITICAL - Subagent Environment Setup**: Each subagent must load environment variables from the `.env` file in the `head-of-marketing` working directory before executing any API calls:
```bash
export $(cat .env | grep -v '^#' | xargs)
```

## Workflow

### 1. Read User Context

Read all files in `.claude/context/` to understand the user's niche, target audience, and accounts to research. Pass this context to each subagent.

### 2. Create Master Run Folder

```bash
RUN_FOLDER="content-plans/$(date +%Y-%m-%d_%H%M%S)" && mkdir -p "$RUN_FOLDER" && echo "$RUN_FOLDER"
```

### 3. Launch Research Subagents in Parallel

Use the Task tool to launch 4 subagents simultaneously:

**Subagent 1 - X Research:**
```
Execute the x-research skill:
1. Create run folder in x-research/
2. Fetch tweets (30 days, 100 max per account)
3. Analyze for outliers
4. Run video analysis if video content found
5. Generate report

Return: The run folder path and a JSON summary with:
- run_folder: path to the run folder
- total_posts: number analyzed
- outlier_count: outliers found
- top_topics: top 5 hashtags/keywords
```

**Subagent 2 - Instagram Research:**
```
Execute the instagram-research skill:
1. Create run folder in instagram-research/
2. Fetch reels (30 days, 50 per account)
3. Analyze for outliers
4. Run video analysis on top 5
5. Generate report

Return: The run folder path and a JSON summary with:
- run_folder: path to the run folder
- total_posts: number analyzed
- outlier_count: outliers found
- top_topics: top 5 hashtags/keywords
```

**Subagent 3 - YouTube Research:**
```
Execute the youtube-research skill:
1. Read channel context from .claude/context/youtube-channel.md
2. Analyze channel for keywords
3. Search for outliers
4. Filter to top 3 relevant videos
5. Run video analysis
6. Generate report

Return: The run folder path and a JSON summary with:
- run_folder: path to the run folder
- total_videos: number analyzed
- outlier_count: outliers found
- top_topics: top 5 keywords
```

**Subagent 4 - TikTok Research:**
```
Execute the tiktok-research skill:
1. Create run folder in tiktok-research/
2. Fetch videos (30 days, 50 per account)
3. Analyze for outliers
4. Run video analysis on top 5
5. Generate report

Return: The run folder path and a JSON summary with:
- run_folder: path to the run folder
- total_videos: number analyzed
- outlier_count: outliers found
- top_topics: top 5 hashtags/sounds/keywords
```

### 4. Collect Research Results

After all subagents complete, read from each platform's latest run folder:

```
x-research/{latest}/
├── outliers.json
└── video-analysis.json (if exists)

instagram-research/{latest}/
├── outliers.json
└── video-analysis.json

youtube-research/{latest}/
├── outliers.json
└── video-analysis.json

tiktok-research/{latest}/
├── outliers.json
└── video-analysis.json
```

### 5. Generate Content Ideas

Read `references/content-ideas-template.md` for the full template structure.

Key aggregation tasks:
1. **Extract topics** from each platform's outliers
2. **Cross-reference** to find topics appearing on multiple platforms
3. **Identify X-sourced emerging ideas** (high X engagement, low presence elsewhere)
4. **Calculate opportunity scores** for X ideas:
   ```
   opportunity_score = (x_engagement × 1.5) / (instagram_saturation + youtube_saturation + tiktok_saturation + 1)
   ```
   - `instagram_saturation`: 0 (not present), 0.5 (low), 1 (medium), 1.5 (high)
   - `youtube_saturation`: same scale
   - `tiktok_saturation`: same scale
5. **Generate 2-week calendar** with platform-specific content suggestions

Write to: `{RUN_FOLDER}/content-ideas.md`

### 6. Generate Platform Playbooks

For each platform, read `references/playbook-template.md` and generate:

- `{RUN_FOLDER}/x-playbook.md`
- `{RUN_FOLDER}/instagram-playbook.md`
- `{RUN_FOLDER}/youtube-playbook.md`
- `{RUN_FOLDER}/tiktok-playbook.md`

Each playbook extracts from the platform's research:
- Winning hooks with replicable formulas (from video-analysis.json)
- Format analysis and content patterns
- Content structure breakdowns
- CTA strategies
- Trending topics and hashtags
- Top 15 outliers with analysis
- Actionable takeaways

### 7. Present Summary

Output to user:
- Total content analyzed across all platforms
- Number of outliers identified per platform
- Key cross-platform insights (2-3 bullets)
- Top 3 emerging ideas from X
- Links to all generated files

## Output Structure

```
content-plans/
└── {YYYY-MM-DD_HHMMSS}/
    ├── content-ideas.md          # Cross-platform ideas (X-primary)
    ├── x-playbook.md             # X/Twitter intelligence playbook
    ├── instagram-playbook.md     # Instagram intelligence playbook
    ├── youtube-playbook.md       # YouTube intelligence playbook
    └── tiktok-playbook.md        # TikTok intelligence playbook
```

## Cross-Platform Topic Matching

To identify cross-platform winners:

1. Extract keywords/hashtags from each platform's outliers
2. Normalize terms (lowercase, remove # and @)
3. Find intersection of high-frequency terms
4. Score by combined engagement across platforms

## Quick Reference

Full orchestration:
1. Create master run folder
2. Launch 4 research subagents in parallel (Task tool with 4 invocations)
3. Wait for all subagents to complete
4. Read all outliers.json and video-analysis.json files
5. Generate content-ideas.md using cross-platform analysis
6. Generate 4 platform playbooks
7. Present summary to user

© bradautomates · MIT · bradautomates/head-of-content

Similar skills

All skills for Marketing and content →

From the same set6

Project sponsors

Companies that keep this analytics open