social-media-analyzer
tessl i github:alirezarezvani/claude-skills --skill social-media-analyzerAnalyzes social media campaign performance across platforms with engagement metrics, ROI calculations, and audience insights for data-driven marketing decisions
Validation
75%| Criteria | Description | Result |
|---|---|---|
description_trigger_hint | Description may be missing an explicit 'when to use' trigger hint (e.g., 'Use when...') | Warning |
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
body_examples | No examples detected (no code fences and no 'Example' wording) | Warning |
Total | 12 / 16 Passed | |
Implementation
22%This skill reads more like a product description or feature list than actionable guidance for Claude. It describes capabilities and outputs but fails to provide executable code, concrete calculation formulas, or step-by-step workflows. The mentioned scripts are not shown or explained, leaving Claude without the actual tools to perform the analysis.
Suggestions
Add executable Python code showing how to calculate key metrics (engagement rate, CTR, ROAS) with actual formulas and example data
Create a clear numbered workflow: 1) Parse input data, 2) Calculate metrics, 3) Validate results, 4) Generate report - with specific code for each step
Include the actual content of calculate_metrics.py and analyze_performance.py, or provide complete inline implementations
Add concrete input/output examples showing sample campaign data and the expected analysis results in specific formats
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is moderately efficient but includes some unnecessary sections like 'Capabilities' that describe what the skill does rather than how to do it. The 'Limitations' section contains information Claude would already understand about data dependencies. | 2 / 3 |
Actionability | The skill lacks any concrete, executable code or specific commands. It mentions scripts like 'calculate_metrics.py' but provides no actual code, usage examples, or even pseudocode showing how to use them. The 'How to Use' section shows prompts, not implementation. | 1 / 3 |
Workflow Clarity | There is no clear workflow or sequence of steps for performing analysis. The 'Best Practices' are general tips, not a process. No validation checkpoints or feedback loops are defined for the analysis workflow. | 1 / 3 |
Progressive Disclosure | The content is organized into sections but everything is in one file with no references to detailed documentation. The scripts are mentioned but not linked or explained. Content that could be separate (like detailed metric formulas) is neither inline nor referenced. | 2 / 3 |
Total | 6 / 12 Passed |
Activation
68%The description effectively communicates specific capabilities for social media analytics with concrete actions and a clear domain focus. However, it lacks an explicit 'Use when...' clause that would help Claude know exactly when to select this skill, and could benefit from more natural trigger terms that users would actually say when requesting this type of analysis.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about social media performance, ad campaigns, engagement rates, or marketing ROI'
Include common platform names and variations users might mention: 'Facebook, Instagram, Twitter, LinkedIn, TikTok, ad performance, post analytics, follower growth'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'engagement metrics, ROI calculations, and audience insights' along with the clear purpose of 'data-driven marketing decisions'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers 'what' (analyzes campaign performance with metrics, ROI, audience insights) but lacks an explicit 'Use when...' clause or equivalent trigger guidance. The 'when' is only implied through the domain description. | 2 / 3 |
Trigger Term Quality | Contains relevant keywords like 'social media', 'campaign', 'engagement metrics', 'ROI', 'marketing', but missing common variations users might say like 'Facebook ads', 'Instagram analytics', 'Twitter metrics', 'ad performance', or specific platform names. | 2 / 3 |
Distinctiveness Conflict Risk | Clear niche focusing specifically on 'social media campaign performance' with distinct domain markers like 'engagement metrics', 'ROI calculations', and 'audience insights' that distinguish it from general analytics or other marketing skills. | 3 / 3 |
Total | 10 / 12 Passed |
Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.