CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

product-analytics

Use when defining product KPIs, building metric dashboards, running cohort or retention analysis, or interpreting feature adoption trends across product stages.

60

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.gemini/skills/product-analytics/SKILL.md

The canonical home for this skill is product-analytics in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, information-dense skill body with concrete commands, useful anti-patterns, and a clear workflow. Its main defect is that every external artifact it points to (two reference files and one script) is missing from the bundle, leaving dangling references and an unusable tooling section.

Suggestions

Add the actual 'references/metrics-frameworks.md', 'references/dashboard-templates.md', and 'scripts/metrics_calculator.py' files to the bundle, or remove the 'See:' list and Tooling section so no path in the body dangles.

Consolidate the Workflow steps 2-4 detail with the duplicated 'KPI Guidance By Stage', 'Dashboard Design Principles', and 'Cohort Analysis Method' sections into one treatment each to cut repeated content.

Add an explicit validation checkpoint to the workflow (e.g., confirm the events CSV matches the user_id/cohort_date/activity_date schema before invoking metrics_calculator.py, and sanity-check the retention matrix for anomalies).

DimensionReasoningScore

Conciseness

The body is dense and specific with no padding or explanation of concepts Claude already knows (e.g., 'Compare retention curves, not single-point snapshots', 'Sharp early drop, low plateau: onboarding mismatch'). However, Workflow steps 2-4 duplicate the later 'KPI Guidance By Stage', 'Dashboard Design Principles', and 'Cohort Analysis Method' sections, which could be consolidated.

4 / 5

Actionability

The Tooling section gives copy-paste-ready commands ('python3 scripts/metrics_calculator.py retention events.csv --format json') plus concrete CSV schemas covering the common cases, and the anti-pattern table pairs each problem with a specific fix. The score is not 5 because the documented script 'scripts/metrics_calculator.py' does not exist in the bundle, so the commands dead-end when followed.

4 / 5

Workflow Clarity

The 5-step Workflow (select framework, define stage-appropriate KPIs, design dashboard layers, run cohort/retention analysis, interpret and act) is clearly sequenced with interpretive checkpoints ('Distinguish signal from noise using period-over-period context'). It is not 5 because there are no explicit validation steps or feedback loops (e.g., verifying the CSV matches the expected schema before running the calculator); the destructive/batch cap does not apply since all operations are read-only analysis.

4 / 5

Progressive Disclosure

Although sections are well organized, the body's 'See:' references to 'references/metrics-frameworks.md' and 'references/dashboard-templates.md' and the entire Tooling section for 'scripts/metrics_calculator.py' point to files that do not exist in the bundle (no references/, scripts/, or assets/ directories are present). Scored against the actual bundle structure, the navigation paths are broken and would mislead the reader, which is worse than the anchor-3 case of merely unclear signaling; it is above anchor 1 because the body itself is well sectioned and the references are at least plainly listed.

2 / 5

Total

14

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit 'Use when' trigger clause, four concrete action gerunds, and natural trigger keywords that are clearly distinct from adjacent analytics skills. It could reach the top anchor by adding a leading capability statement and covering funnel analysis and metric frameworks.

Suggestions

Prepend a capability statement in third person, e.g., 'Defines and interprets product metrics across product stages. Use when...' so the 'what' is explicit rather than implied by the trigger list.

Add funnel analysis and metric-framework selection (AARRR, North Star, HEART) as trigger terms, since these are prominent capabilities of the skill body.

DimensionReasoningScore

Specificity

The description names four concrete actions — 'defining product KPIs, building metric dashboards, running cohort or retention analysis, or interpreting feature adoption trends' — which goes beyond naming the domain. It falls short of anchor 5 because capabilities covered in the body, such as funnel analysis and metric framework selection (AARRR, North Star, HEART), are absent.

4 / 5

Completeness

The 'when' is explicit and well-formed ('Use when defining... building... running... or interpreting...'), and the enumerated activities convey the 'what'. It is not 5 because there is no separate capability statement of what the skill does (e.g., 'Defines, tracks, and interprets product metrics...'), so the 'what' is only implied through the trigger list.

4 / 5

Trigger Term Quality

Good natural keyword coverage: 'product KPIs', 'metric dashboards', 'cohort', 'retention analysis', and 'feature adoption' are phrases users would naturally say. A few common variations are missing, such as 'funnel', 'churn', 'engagement metrics', or 'north star metric'.

4 / 5

Distinctiveness Conflict Risk

The product-analytics niche (KPIs by product stage, cohort/retention, feature adoption) is clearly distinct, and it avoids claiming the neighboring territories of the cross-referenced skills (A/B testing, SaaS finance metrics). Minor overlap risk remains with generic data-analysis or dashboarding skills.

4 / 5

Total

16

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 9 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/product-analytics/SKILL.md

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.