CtrlK
BlogDocsLog inGet started
Tessl Logo

running-clustering-algorithms

Analyze datasets by running clustering algorithms (K-means, DBSCAN, hierarchical) to identify data groups. Use when requesting "run clustering", "cluster analysis", or "group data points". Trigger with relevant phrases based on skill purpose.

49

Quality

55%

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 ./plugins/ai-ml/clustering-algorithm-runner/skills/running-clustering-algorithms/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

20%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a generic, mostly boilerplate overview with no executable guidance and no references to the bundled assets/scripts that actually exist. It has a reasonable high-level workflow sequence and section structure, but fails to be lean or actionable.

Suggestions

Replace the generic boilerplate (Instructions, Output, Resources, Integration) with a concrete runnable example using scikit-learn, and link to the bundled assets/example_data.csv and assets/config_template.json for immediate use.

Surface the bundle: reference assets/clustering_visualization.py for plotting and scripts/run_kmeans.py, run_dbscan.py, run_hierarchical.py for execution, and remove the scripts/README.md entries for files that do not actually exist on disk.

Add validation checkpoints to the workflow (e.g., check silhouette/Davies-Bouldin scores, re-tune parameters if clusters are degenerate) and tighten the Overview to remove restatements of what clustering is.

DimensionReasoningScore

Conciseness

The body restates concepts Claude already knows ("empowers Claude to perform clustering analysis... automated execution of various clustering algorithms, providing insights into data groupings and structures") and is padded with generic boilerplate ("The skill produces structured output relevant to the task", "1. Invoke this skill when the trigger conditions are met"), matching 'Verbose; explains concepts Claude knows; padded with unnecessary context.' It is not a 2 because the filler is pervasive rather than a few tighten-able spots.

1 / 3

Actionability

Despite being a code-generation skill, it provides no executable code or concrete commands, only abstract direction ("Claude generates Python code using appropriate ML libraries (e.g., scikit-learn)", "Always preprocess the data (e.g., scaling, normalization)"), matching 'Vague or abstract; no concrete code/commands; describes rather than instructs.' It is not a 2 because there is not even pseudocode or partial examples, and the bundled example_data.csv/config_template/visualization script are never referenced.

1 / 3

Workflow Clarity

"How It Works" lists a sequenced four-step process (Analyzing the Context, Generating Code, Executing Clustering, Providing Results), matching 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit.' It is not a 3 because there are no validation checkpoints or error-recovery feedback loops, and not a 1 because a clear ordered sequence does exist.

2 / 3

Progressive Disclosure

The body is section-organized but completely ignores the provided bundle files (assets/example_data.csv, config_template.json, clustering_visualization.py; scripts/README.md lists run_kmeans.py etc.), matching 'Some structure but... references present but not clearly signaled; content that should be separate is inline.' It is not a 3 because the overview never points to the existing detailed materials, and not a 1 because the document itself is well-sectioned rather than a monolithic wall.

2 / 3

Total

6

/

12

Passed

Description

90%Weight 40%Scale 1-3

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly communicates both capability and explicit use-when triggers with natural phrasing, and occupies a well-bounded niche. Its only weaknesses are a single compound action rather than multiple discrete ones and a vague trailing filler sentence.

DimensionReasoningScore

Specificity

It names the domain and concrete algorithms ("running clustering algorithms (K-means, DBSCAN, hierarchical) to identify data groups") but describes essentially one pipeline rather than multiple distinct actions, matching 'Names domain and some actions, but not comprehensive.' It is not a 3 because the verbs collapse into a single analyze→cluster→identify workflow rather than several discrete actions.

2 / 3

Completeness

It states what it does ("Analyze datasets by running clustering algorithms... to identify data groups") and gives an explicit when clause ("Use when requesting 'run clustering', 'cluster analysis', or 'group data points'"), matching 'Clearly answers both what AND when with explicit triggers.' It is not a 2 because the trigger guidance is explicit, not merely implied.

3 / 3

Trigger Term Quality

It supplies natural phrases a user would say ("'run clustering'", "'cluster analysis'", "'group data points'"), matching 'Good coverage of natural terms users would say.' It is not a 2 because three distinct, plausible user phrases is better than 'Works with PDF files'; the trailing filler 'Trigger with relevant phrases based on skill purpose' is vague but does not displace the real keywords.

3 / 3

Distinctiveness Conflict Risk

Clustering analysis with named algorithms (K-means, DBSCAN, hierarchical) is a clear niche with distinct triggers unlikely to fire for unrelated skills, matching 'Clear niche with distinct triggers; unlikely to conflict.' It is not a 2 because the scope is sharply bounded to clustering rather than overlapping with generic data skills.

3 / 3

Total

11

/

12

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.