CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

shap

Explain and audit machine-learning predictions with SHAP. Use for selecting SHAP explainers and maskers, computing and validating feature attributions, handling multi-output explanations, and producing local or global SHAP visualizations.

Quality

94%

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 procedural skill body: complete executable examples with built-in validation, a clearly sequenced workflow with an explicit troubleshooting ladder, and disciplined progressive disclosure into a verified one-level reference bundle. The only cost is mild verbosity in version-provenance and citation sections.

DimensionReasoningScore

Conciseness

The body is procedural and assumes competence — no SHAP theory tutorial, legacy details delegated to references/migration.md — but the version-provenance paragraph ('checked on Python 3.12.10 with SHAP 0.52.0, NumPy 2.5.3, pandas 3.0.6, scikit-learn 1.9.1, and matplotlib 3.11.2') and the lengthy citation-fetch instructions could be trimmed or moved. Not 5: these sections exceed 'every token earns its place'; not 3: the bulk is genuinely lean with only minor over-explanation.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: a complete end-to-end example with an additivity assertion (np.testing.assert_allclose against predict_proba), pinned install commands, explicit masker construction, and a runnable bundled script via 'uv run ... scripts/tabular_report.py'. Not 4: the code covers the common tabular case completely with no gaps.

5 / 5

Workflow Clarity

A 7-step sequenced Standard Workflow with explicit validation checkpoints (the reconstruction check, 'Never silence an additivity failure until input shape, preprocessing, model version, output space, and row ordering have been checked') and a numbered 7-step Troubleshooting Order providing an error-recovery feedback loop. Not 4: validation steps are explicit and built into the workflow, not merely implied.

5 / 5

Progressive Disclosure

Overview-level SKILL.md with a Reference Map table giving 'load when' triggers for all 8 referenced files, all of which exist; references are one level deep (cross-links between reference files are peer-level, not nested chains); a bundled script is clearly documented. Not 4: structure, signaling, and file placement are all clean with no organization gaps observed.

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, third-person, tool-specific, with an explicit 'Use for' trigger clause covering the main workflows. The only gap is absence of common synonyms like 'Shapley values' or 'feature importance' that a user might naturally say.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'selecting SHAP explainers and maskers', 'computing and validating feature attributions', 'handling multi-output explanations', 'producing local or global SHAP visualizations' — with comprehensive coverage of the skill's scope. Not 4: there are no minor gaps in coverage; the enumerated actions span selection, computation, validation, and visualization.

5 / 5

Completeness

Explicitly answers both 'what' ('Explain and audit machine-learning predictions with SHAP') and 'when' ('Use for selecting SHAP explainers and maskers, computing and validating feature attributions, ...') with concrete trigger phrases. Not 4: the 'when' clause is explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Natural terms users would say are present ('SHAP', 'explain', 'feature attributions', 'visualizations'), but common synonyms such as 'Shapley values', 'feature importance', or 'interpretability' are missing. Not 5: keyword coverage is good rather than comprehensive; not 3: the core natural phrases users actually use are all there.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (SHAP-based explanation of ML predictions) with distinct, tool-specific triggers; minimal conflict risk with adjacent ML-analysis skills. Not 4: the SHAP-specific framing leaves essentially no overlap ambiguity.

5 / 5

Total

19

/

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

K-Dense-AI/scientific-agent-skills

Path

skills/shap/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.