CtrlK
BlogDocsLog inGet started
Tessl Logo

umap-learn

UMAP dimensionality reduction. Fast nonlinear manifold learning for 2D/3D visualization, clustering preprocessing (HDBSCAN), supervised/parametric UMAP, for high-dimensional data.

60

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./backend/cli/skills/coding/umap-learn/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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-structured, highly actionable body with executable code for every major use case and a proper single-reference bundle layout. Its weaknesses are recurring explanatory padding around the parameter guide and inlined API-detail (the metric enumeration) that belongs in references/api_reference.md.

Suggestions

Trim the 'Purpose:'/'How it works:' scaffolding and general UMAP overview paragraph; keep the effects-by-value ranges and recommendations, which are the actual value.

Move the supported-metrics enumeration to references/api_reference.md, keeping only the 3-4 metric recommendations inline.

Fold the 'When to use' bullets into one-line lead-ins on the code examples instead of separate lists, and add an explicit evaluate→adjust-parameter retry hint in the clustering workflow.

DimensionReasoningScore

Conciseness

The body is mostly efficient — parameter effects and tuning recommendations are genuine value-add — but includes unnecessary padding Claude could infer or already knows: repeated 'Purpose:'/'How it works:' scaffolding per parameter, a general Overview paragraph explaining what UMAP is, and verbose 'When to use' bullets restating what the preceding code already shows. It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, because the padding is recurring across sections, not minor.

3 / 5

Actionability

Nearly every section provides fully executable, copy-paste-ready code covering the common cases: basic fit/transform, tuned parameter combos, supervised/semi-supervised fitting, the full HDBSCAN preprocessing workflow, train/test pipeline integration, and ParametricUMAP usage. Not 4: examples are complete with imports, concrete parameter values, and evaluation output — no pseudocode or missing key details.

5 / 5

Workflow Clarity

Multi-step workflows are clearly numbered (preprocess → fit → visualize; preprocess → UMAP → HDBSCAN → evaluate with adjusted_rand_score) and the Common Issues section provides symptom→fix recovery guidance. It falls short of 5 because validation is advisory rather than an explicit validate→fix→retry checkpoint inside the workflows, and evaluation output is printed but no decision guidance follows it; not 3 because sequences are complete with evaluation and caveats present.

4 / 5

Progressive Disclosure

Good structure: the body is an overview with a clearly signaled, real one-level-deep reference ('references/api_reference.md: Complete UMAP class parameters and methods') with guidance on when to load it. Not 5 because some API-reference-grade detail (the enumeration of ~19 supported metrics, plus per-parameter recommendation prose) is inlined in SKILL.md rather than split into the reference file — a minor organization gap characteristic of the 4 anchor.

4 / 5

Total

16

/

20

Passed

Description

70%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 tight, specific description that names the domain and several concrete capabilities with good trigger terms. Its main weakness is the absence of an explicit 'Use when...' clause, which caps completeness and weakens trigger guidance for users who describe their problem rather than the tool.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user mentions UMAP, embeddings, t-SNE alternatives, or needs to visualize or cluster high-dimensional data.'

Include common synonyms users say, such as 'embedding' and 't-SNE alternative', to broaden natural keyword coverage.

Mention transforming new data / pipeline integration to round out capability coverage.

DimensionReasoningScore

Specificity

The description lists several specific concrete actions — 'Fast nonlinear manifold learning for 2D/3D visualization, clustering preprocessing (HDBSCAN), supervised/parametric UMAP' — which goes beyond naming the domain. It falls short of 5 because coverage has gaps (no mention of transforming new data, inverse transforms, or AlignedUMAP for temporal data, all of which the body documents).

4 / 5

Completeness

The 'what' is clear and specific (UMAP dimensionality reduction with named capabilities), but there is no explicit 'Use when...' clause or equivalent trigger guidance; 'for high-dimensional data' only weakly implies when to use it. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3 even with a clear 'what'.

3 / 5

Trigger Term Quality

Strong natural keywords users would say: 'UMAP', 'dimensionality reduction', 'manifold learning', 'visualization', 'clustering', 'HDBSCAN', 'supervised', 'high-dimensional data'. A few common natural terms are missing — 'embedding', 't-SNE alternative', and file-agnostic phrases like 'visualize high-dimensional data' — so it does not reach 5, but it is well above the 'some relevant keywords' of 3.

4 / 5

Distinctiveness Conflict Risk

UMAP is a clear, named niche with distinct triggers (UMAP, HDBSCAN, manifold learning, parametric UMAP); the description would not plausibly fire for an unrelated skill. It is not 4-level because overlap risk with a hypothetical generic 'dimensionality reduction' skill is minimal — the UMAP-specific terms dominate.

5 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
synthetic-sciences/openscience
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.