Content Calendar Command

Generate a dated, month-long content calendar mapped to topic clusters, keywords, and publishing cadence using existing research data.

Usage

/content-calendar - Generate calendar for current month (2 posts/week)

/content-calendar [posts-per-week] - Custom cadence (e.g., /content-calendar 3)

/content-calendar [posts-per-week] [month] - Custom cadence and month (e.g., /content-calendar 3 next-month)

/content-calendar [posts-per-week] [month] [focus-cluster] - Filter to a specific cluster (e.g., /content-calendar 2 april "content marketing")

What This Command Does

Bridges the gap between /priorities (what to work on) and execution (when to publish). Produces a dated publishing schedule with:

• Specific publish dates assigned to each piece
• Content categorized by type (quick win, rewrite, new article, trending)
• Week-by-week strategy (quick wins first, cluster building later)
• Exact commands to run for each piece
• Parking lot for next month's opportunities

Parameters

Process

1. Parse Parameters

Extract from user input:

• Posts per week: Number (default: 2). Calculate total pieces = postsperweek × weeks in target month.
• Target month: Parse month name (e.g., "april", "next-month", "june"). Default to current month. Determine the year, first day, last day, and number of weeks.
• Focus cluster: Optional text filter. If provided, prioritize items matching this cluster.

2. Run Research Scripts

Check if today's reports already exist before running each script. Skip any script whose report for today is already in research/.

python3 research_quick_wins.py

Generates research/quick-wins-YYYY-MM-DD.md

python3 research_topic_clusters.py

Generates research/topic-clusters-YYYY-MM-DD.md

python3 research_performance_matrix.py

Generates research/performance-matrix-YYYY-MM-DD.md

python3 research_trending.py

Generates research/trending-topics-YYYY-MM-DD.md

Also check for recent competitor gap reports:

• Read research/competitor-gaps-*.md if any exist (use most recent)

Important: If a report for today already exists, skip that script to save API credits. Read the existing report instead.

3. Read and Parse All Reports

Read each generated report and extract:

From Quick Wins:

• Keywords ranking positions 11-20
• Current URLs (existing content)
• Opportunity scores, search volume, impressions
• Commercial intent ratings

From Topic Clusters:

• Cluster names and authority scores
• Weak clusters (biggest opportunities)
• Coverage gaps within each cluster
• Keywords per cluster

From Performance Matrix:

• Declining content (needs refresh)
• Underperforming content
• Content health categories

From Trending Topics:

• Rising search trends
• Time-sensitive opportunities
• Trend velocity scores

From Competitor Gaps (if available):

• Keywords competitors rank for that we don't
• Gap difficulty and volume data

4. Categorize Each Item

Assign every extracted opportunity to one of four content types:

Quick Win Update (Position 11-20, existing content)

• Has a ranking URL
• Needs optimization to move from page 2 to page 1
• Effort: Low-Medium
• Command: /rewrite [topic] or /optimize [file]

Rewrite/Refresh (Declining or underperforming content)

• Performance dropping over time
• Content is stale or outdated
• Effort: Medium
• Command: /rewrite [topic]

New Article (Gaps, cluster building, unranked opportunities)

• No existing content for this keyword
• Fills a cluster gap or competitor gap
• Effort: Medium-High
• Command: /article [topic] or /write [topic]

Trending (Time-sensitive, rising searches)

• Search volume increasing
• Seasonal or news-driven
• Effort: Medium (speed matters)
• Command: /article [topic]

Deduplication: If a keyword appears in multiple reports, keep the highest-priority categorization and note all data sources.

5. Build the Calendar

Assign items to specific dates within the target month, using these weekly strategies:

Week 1: Quick Wins + Trending (Fastest ROI)

• Prioritize quick win updates (low effort, high impact)
• Include any time-sensitive trending topics
• These show results fastest for early momentum

Week 2: Mix of Updates + New Articles

• Remaining quick wins
• Begin new article pipeline
• Balance effort across the week

Week 3: Cluster-Focused (Topical Authority)

• Group related pieces from the same topic cluster
• Build topical authority through cluster coverage
• Include cluster pillar pieces if needed

Week 4+: Strategic New Articles + Rewrites

• Longer-form new content targeting gaps
• Rewrites of declining