CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

step-parts

Use when Replicator needs off-the-shelf STEP parts for screws, bearings, motors, servos, connectors, boards, rails, or other purchasable CAD components before creating placeholder geometry.

Quality

85%

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

88%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 tight, highly actionable body: executable tool and CLI examples, a well-sequenced workflow with sha256 verification and retry/fallback loops, and a sensible split of API detail into a real one-level reference file. The only deductions are slight repetition of the placeholder rule and part-type list, and a provenance pointer to a LICENSE file that is absent from the bundle.

Suggestions

State the placeholder-prohibition rule once (in the workflow or the boundary section) and cut the duplicate phrasing to tighten the intro.

Fix the provenance line: either add the referenced text-to-cad-LICENSE file to the bundle or drop the claim that it is bundled.

Promote the reference pointer into a short 'References' or 'Details' section so navigation to references/step-parts-api.md is signaled structurally rather than as a trailing sentence.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no explanation of what STEP files are or how APIs work; sections carry real payload (tool syntax, CLI examples, flag list). Minor trimmable redundancy: the placeholder prohibition appears twice ("must not be replaced with placeholder boxes or simplified stand-ins" in the intro and "Do not generate placeholder geometry for the selected purchasable part" in workflow step 4) and the part-category list is repeated between the first and second paragraphs. This fits 'Efficient; minor instances ... that could be trimmed' (4) rather than the every-token-earns-its-place anchor (5).

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: a concrete native tool call with realistic arguments (cad.step_parts({"query": "M3 socket head 12", "download": true, "limit": 5})), three real CLI invocations including an exact stable id (--id iso4762_socket_head_cap_screw_m3x12), the literal search endpoint https://api.step.parts/v1/parts, and a specific flag list (--origin, --tag, --out-dir, --all, --overwrite). The examples cover the common cases (query search, id fetch, faceted search), matching the top anchor.

5 / 5

Workflow Clarity

The six-step workflow has a clear sequence with explicit validation and feedback loops: step 3 retries aliases 'before treating an empty result as a miss', step 5 'Verify sha256 when the API record provides it', and an error-recovery fallback ('If no credible STEP/STP source exists, mark the CAD role unresolved or ask for the real 3D file instead of inventing geometry') plus boundary rules for where downloads land. This matches 'Clear sequence with explicit validation steps; feedback loops for error recovery'; it is not a destructive operation and the sha256 checkpoint is unconditional in the workflow, so neither cap at 3 applies.

5 / 5

Progressive Disclosure

Good structure with an appropriate split: endpoint/field bulk lives in the real one-level-deep reference (the body's 'Read references/step-parts-api.md for endpoint and field details' matches the actual file, and scripts/download_step_part.py exists as cited). Two minor gaps keep it below the top anchor: the reference pointer is a single trailing line rather than a clearly signaled navigation section, and the provenance note cites a bundled 'text-to-cad-LICENSE' file that is not present in the bundle — a dangling reference. Fits 'Good structure; most content is appropriately placed; references mostly clear; minor organization gaps'.

4 / 5

Total

18

/

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 well-targeted description with an explicit 'Use when...' trigger clause, strong natural part-type keywords, and a clearly distinct niche. Its main weakness is that the capability (what the skill actually does to obtain the parts) is implied rather than explicitly stated, since the entire sentence is phrased as a trigger condition.

Suggestions

Lead with an explicit capability statement before the trigger clause, e.g., 'Search and download off-the-shelf STEP files for purchasable CAD components... Use when...', so the 'what' is stated as actions rather than implied by the trigger.

Add a few natural synonym terms users say that currently appear only in the body — 'fasteners' and 'STP' — to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names its domain precisely ("off-the-shelf STEP parts for screws, bearings, motors, servos, connectors, boards, rails") but never states the concrete actions the skill performs (e.g., searching/downloading the parts) — the capability is only implied through "needs ... STEP parts". It sits at the 'names domain and 1-2 concrete actions, but not comprehensive' anchor: more concrete than the generic 'Names the domain but actions are minimal' (score 2) because the part categories and 'before creating placeholder geometry' add substance, but below 'Lists several specific actions' (score 4) because no explicit skill actions are enumerated.

3 / 5

Completeness

The 'when' is explicit and strong: "Use when Replicator needs off-the-shelf STEP parts ... before creating placeholder geometry" — a clear 'Use when...' clause with concrete triggers, so it avoids the cap at 3. The 'what' is discernible (sourcing real STEP parts rather than placeholders) but entangled in the trigger clause rather than stated as an explicit capability statement (e.g., 'Searches and downloads STEP files'). This matches 'Has both what and when; when could be more explicit or specific' inverted — the when is excellent, the what could be more explicit — placing it above the weak-what anchor (3) and below the 'clearly and explicitly answers both' anchor (5).

4 / 5

Trigger Term Quality

Strong natural keyword coverage: "screws, bearings, motors, servos, connectors, boards, rails", "STEP parts", "CAD components", "purchasable" — terms a CAD user would naturally say, including the format name (STEP). A few natural variants are missing (e.g., fasteners, bolts, STP, specific model numbers like '608zz' that appear in the body), which keeps it just below the 'comprehensive coverage including synonyms and file extensions' anchor but clearly above 'some relevant keywords but missing common variations' since it lists seven distinct natural part-type terms.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — sourcing purchasable CAD components as real STEP files instead of placeholder geometry — with distinct triggers ("screws, bearings, motors, servos, connectors, boards, rails") that would not collide with generic CAD-modeling or document skills. The 'off-the-shelf'/'purchasable' scoping explicitly separates it from parametric-modeling skills. This matches the 'Clear niche with distinct triggers; minimal conflict risk' anchor.

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

JimmyPeng02/open-replicator

Path

skills/step-parts/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.