CtrlK
BlogDocsLog inGet started
Tessl Logo

setup

Creates the plugin's own Python environment and installs or upgrades mixpanel_headless (0.4.0 or newer) with pandas, numpy, matplotlib, seaborn, networkx, anytree, scipy, and pyarrow (Python 3.11+ only) on Python 3.10+, then checks the imports, mp help, and the credentials. Use when setting up Mixpanel analysis, or when the plugin environment is missing or older than 0.4.0. Do not use for login or account changes (use auth).

74

Quality

93%

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

92%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-engineered setup skill body: exact pre-approved commands, a complete output-interpretation table with error-recovery guidance, and explicit credential/connection verification with defined fallbacks to the auth skill. The referenced bundle script exists and the only real weakness is a small amount of version-history trivia that could be trimmed from the install rationale.

DimensionReasoningScore

Conciseness

The body is lean and operational with no concept explanations Claude already knows, but contains minor over-explanation: the library version history ('mp help, which first shipped in 0.3.0, and on the saved-metric methods, which first shipped in 0.4.0') is time-sensitive trivia not placed in a deprecated/old-patterns section, and the global-Python safety note could be trimmed. This matches anchor 4 (efficient with minor trimmable over-explanation) rather than 5 (every token earns its place).

4 / 5

Actionability

Every step is copy-paste ready: 'bash ${CLAUDE_SKILL_DIR}/scripts/setup.sh ${CLAUDE_PLUGIN_DATA}/venv' is given exactly as the pre-approved pattern, auth commands are fully specified, and the output table maps each printed line to a concrete action. The one placeholder (<account.name>) is explicitly sourced from step 3's output. This matches anchor 5 (fully executable, copy-paste ready, covers common cases).

5 / 5

Workflow Clarity

The four numbered steps are clearly sequenced with explicit validation checkpoints — read the script result table (step 2), switch on the auth 'state' field (step 3), and read 'result.ok' (step 4) — plus feedback loops for error recovery ('run setup again', 'Show the installer output', hand-off to /mixpanel-headless:auth). This matches anchor 5; the operation is non-destructive so the missing-validation cap does not apply.

5 / 5

Progressive Disclosure

The single-purpose setup task is appropriately split: the heavy lifting lives in the real, one-level-deep bundle file scripts/setup.sh (which exists), while SKILL.md stays a well-sectioned orchestration overview (run, read result, check credentials, verify). The inline output-interpretation table and auth-state switch are operationally necessary to this skill and belong inline, matching anchor 5's clear-overview structure.

5 / 5

Total

19

/

20

Passed

Description

92%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: concrete multi-action capability statement with version specifics, an explicit 'Use when' trigger, and a negative boundary that deconflicts it from the auth skill. Third-person voice is used correctly throughout. The only weakness is slightly thin synonym coverage in the trigger phrasing.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Creates the plugin's own Python environment and installs or upgrades mixpanel_headless (0.4.0 or newer) with pandas, numpy, matplotlib, seaborn, networkx, anytree, scipy, and pyarrow', 'checks the imports, mp help, and the credentials' — with version specifics and a full package list, matching the comprehensive-coverage anchor rather than the 4 anchor's 'minor gaps'.

5 / 5

Completeness

It explicitly answers both questions: what ('Creates the plugin's own Python environment and installs or upgrades… then checks the imports, mp help, and the credentials') and when ('Use when setting up Mixpanel analysis, or when the plugin environment is missing or older than 0.4.0'), plus a negative boundary ('Do not use for login or account changes'), matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

'Use when setting up Mixpanel analysis, or when the plugin environment is missing or older than 0.4.0' provides good natural triggers tied to the domain, but common variations users would say (e.g. 'install Mixpanel', 'Mixpanel not working', 'upgrade the plugin') are missing, placing it between the 4 and 5 anchors and closer to 4.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Mixpanel plugin environment setup) with distinct triggers and an explicit deconfliction clause — 'Do not use for login or account changes (use auth)' — minimizing overlap with the sibling auth skill, matching the 5 anchor's 'clear niche with distinct triggers'.

5 / 5

Total

19

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository
mixpanel/mixpanel-headless
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.