| name | instagram-summary |
| description | Generate weekly Instagram account insights and engagement summaries. Use when Claude needs to analyze Instagram performance, create reports on account metrics, or generate summaries for the CEO briefing. This skill runs independently and generates reports in the Reports/ folder. |
Instagram Summary Skill
This skill enables Claude to generate weekly summaries of Instagram account performance by retrieving insights and engagement metrics from the Instagram Graph API v25.
When to Use This Skill
Use this skill when:
- Generating weekly Instagram performance reports for business review
- Creating data for the CEO briefing that includes Instagram metrics
- Analyzing engagement patterns and follower growth on Instagram
- Monitoring the effectiveness of Instagram marketing campaigns
- Tracking key performance indicators for social media strategy
Available Operations
Metrics Collection
- Profile views and reach
- Account impressions and website clicks
- Follower count and growth
- Media interactions and engagement
- Story metrics (when applicable)
- Audience demographics (where available)
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: instagram_summary_request
report_period: weekly | monthly | custom
start_date: "2026-01-01"
end_date: "2026-01-07"
metrics_requested:
- impressions
- reach
- profile_views
- website_clicks
- follower_count
- email_contacts
- get_directions_clicks
target_audience: executive_team | marketing_team | social_media_manager
additional_analysis:
- trend_analysis
- anomaly_detection
- top_performing_posts
---
Execution Process
- Check for optional configuration files in
AI_Employee_Vault/Needs_Action/ (if none, use default weekly report)
- Connect to Instagram Graph API using configured access token
- Retrieve requested metrics for the specified period
- Process and analyze the data
- Generate a markdown report with insights and trends
- Save the report to
AI_Employee_Vault/Reports/Instagram_Summary_YYYY-MM-DD.md
- Log the operation to the audit log
- Update Dashboard.md with summary status
- Optionally trigger alerts for anomalies detected
Report Structure
The generated report includes:
- Header: Report period and generation timestamp
- Key Metrics: Impressions, reach, profile views, website clicks, followers
- 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 Instagram summary operations are logged to AI_Employee_Vault/Logs/YYYY-MM-DD.json with:
- Timestamp
- Action type (summary_generation)
- Actor (Claude)
- Data sources accessed (Instagram 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 follower growth patterns
- Low engagement rates on high-reach posts
- Unexpected demographic shifts
Test Plan
- Create a test request file in
AI_Employee_Vault/Needs_Action/TEST_instagram_summary_2026-01-07.md
- Run the skill and verify it generates a report
- Check that the report is saved to
AI_Employee_Vault/Reports/
- Verify the audit log contains the operation
- Check that Dashboard.md was updated with summary status
- Verify anomaly detection works with test data
Dependencies
- Valid Instagram Business/Creator account linked to Facebook Page
- Properly configured Instagram access token with insights permissions
- Instagram account with sufficient activity for metrics
- Internet connectivity to reach Instagram Graph API
- Proper permissions to write to Reports folder
