agentleFS
r0undm1dn1ghty-starr0undm1dn1ghty-star/ds_content-radar/.claude/skills/content-planner/SKILL.md

content-planner

Skill0 starsChanged 35 days agoMITView on GitHub

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.

  • Reads credentials

8 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use content-writer.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • chrispanggSkill

    content-writer

    Writing content across different platforms and styles. This skill should be used when creating blog posts, LinkedIn posts, X/Twitter threads, technical documentation, or other written content. It intelligently selects the appropriate writing style based on the platform, audience, and content type, then applies that style consistently throughout the piece.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 4 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 8 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

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

    line 43
  2. Distinctive:

    Use the Task tool to launch 4 subagents simultaneously:

    line 53
  3. Distinctive:

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

    line 122
  4. Very specific:

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

    line 144
  5. Distinctive:

    Create master run folder

    line 212
  6. Distinctive:

    Wait for all subagents to complete

    line 214
  7. Very specific:

    Read all outliers.json and video-analysis.json files

    line 215

“Common” is measured: kept by at least 6 in 10 of the 8 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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:

  • XAPI_TOKEN (twitterapi.io) for X research; Instagram/TikTok are free (instaloader session + yt-dlp)
  • YouTube needs no key (yt-dlp + local z-score outlier math)
  • 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:

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

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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.