CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs

Use whenever creating or editing PyMC-Marketing documentation, including small updates to existing notebooks. Apply the repository's documentation conventions and notebook visibility policy.

Quality

89%

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

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

An exemplary lean, single-purpose skill: concrete decision rules with exact tag names and metadata locations, an explicit validation step for visibility-only edits, and no wasted tokens. It fully earns top marks across all content dimensions for its size and scope.

DimensionReasoningScore

Conciseness

The body is ~20 lean lines with zero padding and no explanation of concepts Claude already knows; every rule ('Show code central to the teaching arc', 'Add tags to cell.metadata.tags, preserving existing tags, code, and stored outputs') earns its place. It matches the 'lean and efficient; assumes Claude's competence' anchor.

5 / 5

Actionability

Guidance is fully concrete for an instruction-only skill: exact tag values ('hide-input', 'hide-output'), the exact metadata location ('cell.metadata.tags'), and per-case decision rules covering the common cases (incidental plotting, MCMC messages, explanatory figures). The scoring note says absence of code is not penalized when the guidance is this actionable, so it fits the top anchor.

5 / 5

Workflow Clarity

The sequence is clear: review visibility per cell, add tags while preserving existing content, then 'Check the rendered page when practical' and 'validate notebook structure and confirm code and results are unchanged'. Validation checkpoints are explicitly present, and the simple-skill exception (single task, under 50 lines) applies, so it is not capped at 3.

5 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references (no references/, scripts/, or assets/ bundle exists), and is organized into well-organized sections ('Notebook visibility' plus framing lines). Per the judging guideline, this matches the top anchor for simple skills.

5 / 5

Total

20

/

20

Passed

Description

73%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 solid description with an explicit 'Use whenever' trigger and a clearly scoped, distinctive niche tied to PyMC-Marketing. Its main weakness is that the 'what' is somewhat abstract — it invokes 'conventions and notebook visibility policy' rather than naming the concrete actions it performs.

Suggestions

Name 1-2 more concrete actions in the description, e.g. 'Set hide-input/hide-output cell tags and review notebook visibility' instead of the abstract 'Apply the repository's documentation conventions and notebook visibility policy'.

Add natural synonym trigger terms such as 'docs' or 'user guide' alongside 'documentation' and 'notebooks'.

DimensionReasoningScore

Specificity

The description names the domain ('PyMC-Marketing documentation') and 1-2 actions ('creating or editing', 'Apply the repository's documentation conventions and notebook visibility policy'), matching the anchor for domain plus 1-2 concrete actions. It does not list several distinct specific actions, so it falls short of level 4.

3 / 5

Completeness

It explicitly answers 'when' with a clear 'Use whenever creating or editing...' trigger clause including small updates, and answers 'what' with 'Apply the repository's documentation conventions and notebook visibility policy'. The 'what' is somewhat abstract, keeping it below level 5.

4 / 5

Trigger Term Quality

Natural terms like 'documentation', 'notebooks', and the project name 'PyMC-Marketing' give good keyword coverage a user would naturally say. It lacks common synonyms and variations such as 'docs' or 'user guide', so it does not reach level 5.

4 / 5

Distinctiveness Conflict Risk

Anchored to the specific named repository (PyMC-Marketing) with distinct triggers around documentation and notebooks, giving it a clear niche with minimal conflict risk against generic skills.

5 / 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

pymc-labs/pymc-marketing

Path

.agents/skills/docs/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.