name: analytics-expert
description: This skill should be used when users need help analyzing content analytics data, creating reports, identifying trends, calculating ROI, or providing content optimization recommendations. It activates when users ask analytics questions, request reports, need performance analysis, ROI calculations, trend identification, or content optimization recommendations.

Content Analytics Expert

Overview

This skill enables Claude to analyze content analytics data, generate comprehensive reports, identify performance trends, calculate ROI and revenue attribution, and provide actionable insights for content optimization.

When to Use This Skill

This skill activates automatically when users:

• Ask analytics questions or request performance reports
• Need help analyzing content performance data
• Want ROI calculations or revenue attribution analysis
• Request trend identification from analytics data
• Need content optimization recommendations based on data
• Want to understand which content performs best and why

Core Capabilities

1. Generate Analytics Reports

To generate comprehensive analytics reports:

1. Collect Analytics Data

2. Access analytics platform data (discover from project)

3. Aggregate performance metrics across platforms
4. Gather engagement data (views, likes, comments, shares)

5. Collect conversion and revenue data (if available)

6. Create Report Structure

7. Weekly/Monthly performance reports

8. Platform-specific performance analysis
9. Content type performance comparison
10. Audience engagement reports

11. ROI and revenue attribution reports

12. Generate Report Content

13. Summarize key metrics and insights
14. Create data visualizations (charts, graphs)
15. Identify top-performing content
16. Highlight trends and patterns
17. Provide actionable recommendations

Example User Request:
"Generate a monthly performance report for my content"

Integration (discover from project):

• Analytics Platform: Access performance data
• Content Management Platform: Store and share reports
• Publishing Platform: Use insights for scheduling optimization

2. Identify Top-Performing Content Patterns

To identify patterns in top-performing content:

1. Analyze Performance Data

2. Review content performance metrics

3. Identify top-performing content pieces

4. Analyze common characteristics of successful content

5. Extract Patterns

6. Content topics and themes

7. Content formats and types
8. Posting times and frequencies
9. Platform-specific patterns

10. Engagement drivers (hooks, CTAs, visuals)

11. Generate Insights

12. Document successful content patterns
13. Recommend content strategies based on patterns
14. Suggest content replication opportunities

Example User Request:
"What patterns do you see in my top-performing content?"

Integration (discover from project):

• Analytics Platform: Analyze performance data
• Content Creation Tools: Apply patterns to new content generation
• Content Management Platform: Store pattern insights

3. Predict Content Performance

To predict content performance before publishing:

1. Analyze Historical Data

2. Review similar content performance

3. Identify factors that correlate with success

4. Build performance prediction models

5. Evaluate New Content

6. Compare new content to historical patterns

7. Assess content against success factors

8. Calculate predicted performance scores

9. Provide Recommendations

10. Suggest content improvements
11. Recommend optimal posting times
12. Identify best platforms for content
13. Predict viral potential

Example User Request:
"Predict how well this content will perform before I publish it"

Integration (discover from project):

• Analytics Platform: Use historical data for predictions
• Content Creation Tools: Optimize content before generation
• Publishing Platform: Optimize scheduling based on predictions

4. ROI Analysis and Attribution

To calculate ROI and revenue attribution:

1. Track Revenue Metrics

2. Link content to conversions and revenue

3. Track attribution through project's tracking links (discover format from project docs)

4. Calculate cost per content piece (API costs, time)

5. Calculate ROI

6. Revenue per content piece

7. Cost to create content
8. ROI percentage calculation

9. Revenue per platform/channel

10. Generate ROI Reports

11. Content-level ROI analysis
12. Platform ROI comparison
13. Campaign ROI tracking
14. Revenue optimization recommendations

Example User Request:
"Calculate the ROI for my content and show me which pieces drive the most revenue"

Integration (discover from project):

• Analytics Platform: Track conversions and revenue
• Content Management Platform: Store ROI data and reports
• Publishing Platform: Optimize distribution based on ROI

5. Trend Identification

To identify trends from analytics data:

1. Analyze Time-Series Data

2. Review performance trends over time

3. Identify growth or decline patterns

4. Detect seasonal trends

5. Identify Emerging Trends

6. Content topics gaining traction

7. Platform trends and shifts
8. Audience behavior changes

9. Engagement pattern shifts

10. Provide Trend Insights

11. Document identified trends
12. Recommend actions based on trends
13. Predict future trend directions

Example User Request:
"What trends do you see in my content performance over the last 3 months?"

Integration (discover from project):

• Analytics Platform: Analyze time-series data
• Content Management Platform: Store trend insights
• Content Creation Tools: Apply trends to content generation

Project Context Discovery

Before analyzing analytics, discover the project's context:

1. Scan Project Documentation:

2. Check .agent/SYSTEM/ARCHITECTURE.md for analytics platform details

3. Review .agent/SYSTEM/SUMMARY.md for analytics capabilities

4. Look for analytics-related documentation

5. Identify Analytics Platform:

6. Check for analytics service integrations in codebase

7. Look for analytics API endpoints or SDKs

8. Review environment variables for analytics services

9. Discover Available Metrics:

10. Review analytics API documentation if available
11. Check for analytics data models or schemas
12. Identify what metrics the project tracks

Common Analytics Data Types (adapt based on discovery):

• Post-level metrics: Views, Likes, Comments, Shares, Engagement Rate
• Platform-specific metrics: Performance by platform
• Time-based metrics: Performance over time (7d, 30d, 90d)
• Conversion metrics: Clicks, signups, revenue (via tracking links)
• Content type metrics: Performance by content type

Key Metrics:

• Engagement Rate: (Likes + Comments + Shares) / Views
• ROI: (Revenue - Cost) / Cost × 100
• Conversion Rate: Conversions / Clicks
• Average Performance: Aggregate metrics across content

Best Practices

1. Data-Driven Insights: Base all recommendations on actual analytics data
2. Context Matters: Consider platform, timing, and audience when analyzing data
3. Actionable Recommendations: Provide specific, actionable insights, not just data
4. Comparative Analysis: Compare performance against benchmarks and historical data
5. Continuous Monitoring: Recommend regular analytics review and optimization

Resources

references/

• analytics-api-reference.md: Project analytics API endpoints and data structures (discover from project docs)
• roi-calculation-guide.md: ROI calculation methods and formulas
• performance-benchmarks.md: Industry benchmarks for content performance

assets/

• analytics-report-template.md: Template for analytics reports
• roi-report-template.md: Template for ROI analysis reports
• trend-analysis-template.md: Template for trend identification reports

Complementary Skills (External)

For A/B testing and analytics tracking, pair with coreyhaines31/marketingskills:

/plugin marketplace add coreyhaines31/marketingskills