CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mixpanelyst

This skill should be used when the user asks about Mixpanel product analytics, event data, funnel analysis, retention curves, cohort analysis, segmentation queries, user behavior, conversion rates, churn, DAU/MAU, ARPU, revenue metrics, feature adoption, A/B test results, user paths, flow analysis, or any request to query, explore, visualize, or analyze Mixpanel data using Python. Also use when the user asks to read, write, or manage Mixpanel "business context" — the markdown documentation that grounds AI assistants in an organization's structure and goals.

72

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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.

The body delivers exceptional actionability and workflow discipline — discovery-first querying, parameter sweeps, silent-default warnings, and verification loops are all exemplary. Its weaknesses are the two structural ones: the 59KB monolithic body inlines what belongs in reference files (only scripts/help.py and external WebFetch URLs provide offloading), and a few sections (numpy/scipy/matplotlib, exhaustive CRUD listings) restate knowledge Claude already has.

Suggestions

Move the full API signatures (Workspace/query engines, legacy queries, entity CRUD listings, Key Types) into a references/api.md (or lean on help.py plus a short index), keeping SKILL.md to the quick-start, discovery workflow, and analytical guidance — this would cut the always-loaded body dramatically.

Trim or delete the 'Statistical Analysis — numpy, scipy' and 'Visualization — matplotlib, seaborn' sections to one-line pointers (e.g., 'results are DataFrames; use Agg backend for saved charts'), since Claude already knows this material.

Replace the exhaustive per-entity CRUD method name listings with a single 'python3 $SKILL_DIR/scripts/help.py search <entity>' instruction plus one small example, so the CRUD surface stays discoverable without inlining every method name.

DimensionReasoningScore

Conciseness

The body is ~1060 lines and most of it earns its place (Mixpanel-specific signatures, silent-default traps, regex-engine quirks), but the 'Statistical Analysis' and 'Visualization' sections re-explain t-tests, Cohen's d, matplotlib's Agg backend, and seaborn functions Claude already knows, and the bulk of the API/CRUD reference (every entity method name, full legacy query signatures) could be tightened or delegated to help.py and the linked full references. Not 4: this is more than 'minor instances of over-explanation' — the body is a 59KB monolith. Not 2: it is not padded with generic conceptual explanation; nearly everything is library-specific and non-inferable.

3 / 5

Actionability

Fully executable guidance throughout: complete method signatures with per-parameter comments, copy-paste runnable sweeps (MathType sweep, conversion-window sweep, cardinality sweep, aggregate sweep), exact `python3 $SKILL_DIR/scripts/help.py <Name>` commands with expected output, and a working `CreateCustomPropertyParams(...)` example. Placeholders like `event = 'Purchase' # use a real event name` are deliberate and backed by the discovery workflow, so there are no real gaps. Not 4: the common cases are covered concretely, not just 'mostly'.

5 / 5

Workflow Clarity

Sequences are explicit with validation checkpoints and feedback loops: 'Discovery — ALWAYS Do Both Steps Before Querying' (guessing causes 'silent empty results'), the five-step exploratory workflow, custom-property creation with 'Verify by querying with the custom property as group_by', and a checklist of analytical principles in 'Multi-Step Analysis Patterns'. Not 4: checkpoints are explicit rather than merely present — error recovery is directly addressed (wrong parameter names → TypeErrors → run help.py first). The CRUD section is a method inventory, not a destructive workflow, so the destructive-cap does not apply to the described workflows.

5 / 5

Progressive Disclosure

There is good section structure and genuine on-demand references (help.py as a real bundled lookup tool, one-level-deep WebFetch guides, llms.txt), but the core API reference — full Workspace/query/funnel/retention signatures, every CRUD entity method, legacy queries, and the entire custom-property formula language — is inlined into SKILL.md rather than split into reference files, making it load in full on every invocation. Not 4: 'content that should be separate is inline' describes most of the body, which is the anchor-3 condition. Not 2: references are clearly signaled and the document is well sectioned, not unstructured.

3 / 5

Total

16

/

20

Passed

Description

100%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.

An excellent description: concrete capabilities, explicit 'use when' triggers in third person, and dense natural-language trigger terms covering the full Mixpanel analytics vocabulary. It clearly delineates a distinct niche with minimal conflict risk.

DimensionReasoningScore

Specificity

The description lists many concrete capabilities: "funnel analysis, retention curves, cohort analysis, segmentation queries... conversion rates, churn, DAU/MAU, ARPU, revenue metrics, feature adoption, A/B test results, user paths, flow analysis" plus "query, explore, visualize, or analyze Mixpanel data using Python" and read/write/manage "business context" — comprehensive coverage of the skill's actions. Not 4: coverage is full, not 'several actions with minor gaps'.

5 / 5

Completeness

It explicitly answers 'when' ("This skill should be used when the user asks about..." / "Also use when the user asks to read, write, or manage...") and 'what' (query, explore, visualize, analyze Mixpanel data in Python; read/write/manage business context) with concrete trigger phrases. Not 4: both halves are explicit and specific rather than 'could be more explicit'.

5 / 5

Trigger Term Quality

It enumerates the natural phrases analytics users actually say — "funnel analysis", "retention curves", "churn", "DAU/MAU", "ARPU", "A/B test results", "conversion rates", "feature adoption", "user paths" — comprehensive synonym-level coverage of the Mixpanel analytics vocabulary. Not 4: there are no common natural terms missing; both metric jargon and plain-language variants ("user behavior", "conversion rates") are present.

5 / 5

Distinctiveness Conflict Risk

"Mixpanel" is a clear niche brand anchoring every trigger; the vocabulary (Mixpanel, cohort, DAU/MAU, business context) is distinct from generic analytics or BI skills, so it is unlikely to fire for the wrong skill. Not 4: the brand plus specific metric terms give minimal overlap risk rather than 'minor overlap'.

5 / 5

Total

20

/

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

skill_md_line_count

SKILL.md is long (1060 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

openai/plugins

Path

plugins/mixpanel-headless/skills/mixpanelyst/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.