CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mixpanel-headless-setup

This skill installs mixpanel_headless, pandas, numpy, matplotlib, seaborn, networkx, anytree, scipy (and pyarrow on Python 3.11+), then verifies Mixpanel credentials. It should be invoked when setting up a new environment for Mixpanel data analysis, when dependencies are missing, or when configuring service account or OAuth credentials for the first time.

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

88%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-built operational skill body: fully executable commands with explicit validation (session state parsing, account test) and per-failure recovery branches, plus correctly wired bundle references. Minor room to trim redundant inline examples and rely more on the referenced API docs, but nothing pads or explains what Claude already knows.

DimensionReasoningScore

Conciseness

The body stays operational throughout (commands, JSON state parsing, exact env var exports) with no padding explaining concepts Claude already knows, but a few sections could be trimmed — the 'frictionless one-shot path' framing and the Workspace constructor variants that duplicate the linked python-api.md reference. Anchor 4 fits: efficient with minor instances that could be trimmed; anchor 5 would require every token earning its place, which the inline Workspace tour does not.

4 / 5

Actionability

Every step is copy-paste ready: 'bash $SKILL_DIR/scripts/setup.sh', the auth_manager.py session/account-test invocations with field-level JSON interpretation ('result.ok: true'), 'mp login' with its flags, exact export blocks for MP_USERNAME/MP_SECRET/MP_PROJECT_ID/MP_REGION, and the export-bridge recovery commands. Anchor 5 fits: specific executable commands cover the common cases, and nothing is pseudocode.

5 / 5

Workflow Clarity

The sequence is explicit (run setup.sh → check session → parse the 'state' field → branch per state → verify with 'account test'), with explicit validation checkpoints and error-recovery feedback loops for each failure mode (needs_account onboarding, needs_project pinning, expired bridge re-auth, result.ok: false). Anchor 5 fits; the destructive/batch cap does not apply since this is an install/verify skill, and anchor 4 would require missing checkpoints, which are absent.

5 / 5

Progressive Disclosure

The bundled scripts/setup.sh is real and correctly referenced, and bulk detail (full Python API, analytical frameworks) is pushed to one-level-deep, clearly signaled links ('see analytical-frameworks.md', 'see python-api.md'). However those links point into a sibling skill's references/ rather than this skill's own bundle, and the four credential-method walkthroughs are inline, so anchor 4 (good structure, minor organization gaps) fits better than anchor 5.

4 / 5

Total

18

/

20

Passed

Description

88%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: third-person, fully enumerated concrete actions, and an explicit multi-condition 'when' clause covering new-environment setup, missing dependencies, and first-time credential configuration. The only weaknesses are a few missing natural trigger variations and slight overlap risk with the closely related Mixpanel analytics skill.

DimensionReasoningScore

Specificity

The description enumerates the full package set ('installs mixpanel_headless, pandas, numpy, matplotlib, seaborn, networkx, anytree, scipy (and pyarrow on Python 3.11+)') and a second concrete action ('verifies Mixpanel credentials'), comprehensively covering a setup skill's scope in third-person voice. Anchor 5 fits because there are no coverage gaps; anchor 4 would require missing actions, and none exist for this skill's purpose.

5 / 5

Completeness

It explicitly answers 'what' (install the listed packages, then verify Mixpanel credentials) and 'when' with three concrete trigger conditions ('when setting up a new environment for Mixpanel data analysis, when dependencies are missing, or when configuring service account or OAuth credentials for the first time'). This matches anchor 5 exactly; anchor 4 would require a less explicit 'when' clause, which is not the case here.

5 / 5

Trigger Term Quality

Trigger phrases like 'setting up a new environment', 'dependencies are missing', and 'configuring service account or OAuth credentials for the first time' are natural user phrasings, but common variants users would say (e.g. 'install', 'environment setup', 'Mixpanel not working') are absent. This lands between anchor 4 (good coverage, a few natural terms missing) and anchor 5 (comprehensive with synonyms), noticeably above the midpoint.

4 / 5

Distinctiveness Conflict Risk

The Mixpanel-setup niche is clear, but the trigger 'setting up a new environment for Mixpanel data analysis' overlaps with the sibling analytics skill that 'auto-triggers on analytics questions', creating minor conflict risk with a closely related skill. Anchor 4 fits; anchor 5 would require minimal conflict risk, and anchor 3 would imply overlap with many similar skills rather than one sibling.

4 / 5

Total

18

/

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

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

openai/plugins

Path

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