content-planner_skill

Overview

This skill orchestrates parallel content research across X, Instagram, YouTube, and TikTok, then aggregates findings into actionable content ideas and platform-specific playbooks. It runs four research subagents simultaneously, collects outliers and video analysis, and produces a two-week content calendar plus four intelligence playbooks tailored to each platform.

How this skill works

The skill reads account and audience context, creates a timestamped run folder, and launches X, Instagram, YouTube, and TikTok research subagents in parallel. Each subagent fetches recent posts/videos, detects outliers, runs video analysis where relevant, and returns a run folder path plus a compact JSON summary. The orchestration aggregates those outputs, extracts cross-platform topics, scores opportunities, generates content-ideas.md and four platform playbooks, and presents a concise summary and links to generated files.

When to use it

• When you need a multi-platform content plan grounded in recent performance.
• When researching trends, hashtags, and hooks across X, Instagram, YouTube, and TikTok.
• When you want platform-specific playbooks with replicable hooks and CTAs.
• When you need a prioritized set of emerging ideas from X with opportunity scoring.
• When preparing a 2-week content calendar aligned across platforms.

Best practices

• Ensure APIFY_TOKEN, TUBELAB_API_KEY, and GEMINI_API_KEY are set and accounts are in .claude/context.
• Run from the head-of-marketing directory and export the .env variables before starting subagents.
• Provide clear niche and audience files in .claude/context/ to improve relevance.
• Review video-analysis.json outputs to extract replicable hooks and formats.
• Use the opportunity_score outputs to prioritize X-originating ideas for multi-platform testing.

Example use cases

• Create a 2-week cross-platform content calendar for a niche SaaS brand.
• Aggregate trend research for a creator launching a new series on YouTube and short-form platforms.
• Build platform playbooks with winning hooks and CTA formulas for a product launch.
• Identify under-exploited X ideas with high engagement potential elsewhere.
• Run a comprehensive audit of recent 30-day activity across four platforms before a campaign.