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.

64

Quality

80%

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 ./product-team/skills/product-analytics/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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-organized, lean body with executable tooling documentation and specific domain guidance across KPI definition by stage, dashboard layering, and cohort/retention analysis. The remaining gaps are mostly signaling: the reference list lacks labels, and the analytical workflow is not connected to the provided script commands.

Suggestions

Replace the bare 'See:' list with labeled, well-placed pointers (e.g., a References section with '**Framework details**: see references/metrics-frameworks.md') so each file's purpose is signaled.

Tie workflow step 4 directly to the tooling, e.g., 'Run `python3 scripts/metrics_calculator.py cohort events.csv --cohort-grain week` to build the retention matrix'.

Trim the 'When To Use' section, which duplicates the frontmatter description, to reclaim tokens.

DimensionReasoningScore

Conciseness

The body is dense with domain-specific guidance ("Executive layer: 5-7 directional metrics", "Compare retention curves, not single-point snapshots") and explains nothing Claude already knows. Not 5: the 'When To Use' bullet list and the opening line largely restate the frontmatter description and could be trimmed.

4 / 5

Actionability

Fully copy-paste-ready commands with flags and output formats ('python3 scripts/metrics_calculator.py cohort events.csv --cohort-grain week --format json') plus sample CSV schemas cover retention, cohort, and funnel cases, and guidance elsewhere is specific. Not 5: the 5-step Workflow never ties its steps to these commands — step 4 'Run cohort + retention analysis' does not reference the calculator script.

4 / 5

Workflow Clarity

The 5-step workflow (framework → KPIs → dashboard layers → cohort analysis → interpret and act) is clearly sequenced, with interpretive checkpoints such as 'Distinguish signal from noise using period-over-period context' and 'Connect metric movement to product changes and release timeline'. Not 5: no explicit validate-and-correct loop, acceptable here since the operations are non-destructive analysis.

4 / 5

Progressive Disclosure

References are real and one level deep — references/metrics-frameworks.md and references/dashboard-templates.md exist and carry the framework/dashboard detail, while the body keeps one-line summaries (e.g., 'AARRR for growth loops and funnel visibility'). Not 5: the mid-document 'See:' list is bare paths with no per-file labels, placed oddly under Dashboard Design Principles rather than a clearly signaled references section.

4 / 5

Total

16

/

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 and four concrete, natural-sounding actions in a distinct product-analytics niche. It sits just below the top anchor because the 'what' is only embedded in the trigger clause and a few natural trigger terms (funnel, churn, North Star) are missing.

Suggestions

Lead with a standalone what-statement before the trigger (e.g., 'Define, track, and interpret product metrics across product stages. Use when...') so 'what' is explicit, not just embedded in the when-clause.

Add missing natural trigger terms such as 'funnel analysis', 'churn', and 'North Star metric' to broaden keyword coverage toward comprehensive.

Mention metric framework selection (AARRR, North Star, HEART) to close the coverage gap and further sharpen distinctiveness against generic analytics skills.

DimensionReasoningScore

Specificity

Four concrete actions are named — "defining product KPIs", "building metric dashboards", "running cohort or retention analysis", "interpreting feature adoption trends" — matching the 'several specific actions, minor gaps' anchor. Not 5: the skill's funnel analysis and metric-framework selection (AARRR/North Star/HEART) capabilities from the body are absent from the description.

4 / 5

Completeness

An explicit "Use when defining product KPIs, building metric dashboards..." clause answers 'when' concretely, and the embedded activities convey the 'what'. Not 5: there is no standalone what-statement (e.g., 'Define, track, and interpret product metrics') — the 'what' exists only inside the trigger clause, short of the explicit dual what+when structure of the top anchor.

4 / 5

Trigger Term Quality

"product KPIs", "metric dashboards", "cohort", "retention analysis", and "feature adoption" are phrases users would naturally say when needing this skill. Not 5: common variations such as "funnel", "churn", "North Star", and "analytics" are missing, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The product-metrics niche ("product KPIs", "cohort or retention analysis", "feature adoption") is clearly distinct from generic skills. Not 5: "metric dashboards" overlaps visualization/dashboard skills and "retention analysis" brushes the churn/LTV territory of the sibling SaaS-metrics skill this body cross-references.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

alirezarezvani/claude-skills

Path

product-team/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.