facebook-summary

name	facebook-summary
description	Generate weekly Facebook page insights and engagement summaries. Use when Claude needs to analyze Facebook performance, create reports on page metrics, or generate summaries for the CEO briefing. This skill runs independently and generates reports in the Reports/ folder.

Facebook Summary Skill

This skill enables Claude to generate weekly summaries of Facebook page performance by retrieving insights and engagement metrics from the Facebook Graph API v22.

When to Use This Skill

Use this skill when:

1. Generating weekly Facebook performance reports for business review
2. Creating data for the CEO briefing that includes Facebook metrics
3. Analyzing engagement patterns and audience growth on Facebook
4. Monitoring the effectiveness of Facebook marketing campaigns
5. Tracking key performance indicators for social media strategy

Available Operations

Metrics Collection

• Page impressions and reach
• Engaged users and fan additions
• Video views and engagement
• Post performance metrics
• Audience demographics (where available)
• Click-through rates on links

Report Generation

• Weekly summary reports in markdown format
• Trend analysis and insights
• Comparison with previous periods
• Anomaly detection in engagement patterns

Input Format

This skill can work with optional configuration files in the AI_Employee_Vault/Needs_Action/ folder with the following format:

---
type: facebook_summary_request
report_period: weekly | monthly | custom
start_date: "2026-01-01"
end_date: "2026-01-07"
metrics_requested:
  - page_impressions
  - page_engaged_users
  - page_fan_adds
  - page_video_views
  - page_content_activity
target_audience: executive_team | marketing_team | social_media_manager
additional_analysis:
  - trend_analysis
  - anomaly_detection
  - competitor_comparison
---

Execution Process

1. Check for optional configuration files in AI_Employee_Vault/Needs_Action/ (if none, use default weekly report)
2. Connect to Facebook Graph API using configured access token
3. Retrieve requested metrics for the specified period
4. Process and analyze the data
5. Generate a markdown report with insights and trends
6. Save the report to AI_Employee_Vault/Reports/Facebook_Summary_YYYY-MM-DD.md
7. Log the operation to the audit log
8. Update Dashboard.md with summary status
9. Optionally trigger alerts for anomalies detected

Report Structure

The generated report includes:

• Header: Report period and generation timestamp
• Key Metrics: Impressions, reach, engagement, fan growth, video views
• Trend Analysis: Comparison with previous periods
• Top Performing Content: Best-performing posts
• Audience Insights: Demographics and behavior
• Anomalies: Unusual patterns or significant changes
• Recommendations: Actionable insights for improvement

Frequency and Scheduling

• Standard frequency: Weekly (runs every Sunday)
• Can be run on-demand for custom periods
• Historical data available for comparison

Error Handling

• If API credentials are invalid, alert user and pause operation
• If rate limits are reached, wait and retry or reschedule
• If data is unavailable for requested period, note in report
• Log all errors to audit trail with appropriate severity

Audit Trail

All Facebook summary operations are logged to AI_Employee_Vault/Logs/YYYY-MM-DD.json with:

• Timestamp
• Action type (summary_generation)
• Actor (Claude)
• Data sources accessed (Facebook Graph API)
• Metrics retrieved
• Report file created
• Result of the operation
• Anomalies detected

Anomaly Detection

The skill automatically detects and highlights:

• Significant drops in engagement (>20% from previous period)
• Unusually high reach or impressions (>50% from previous period)
• Abnormal fan growth patterns
• Low video completion rates
• Unexpected demographic shifts

Test Plan

1. Create a test request file in AI_Employee_Vault/Needs_Action/TEST_facebook_summary_2026-01-07.md
2. Run the skill and verify it generates a report
3. Check that the report is saved to AI_Employee_Vault/Reports/
4. Verify the audit log contains the operation
5. Check that Dashboard.md was updated with summary status
6. Verify anomaly detection works with test data

Dependencies

• Valid Facebook Page access token with insights permissions
• Facebook Page with sufficient activity for metrics
• Internet connectivity to reach Facebook Graph API
• Proper permissions to write to Reports folder