CtrlK
BlogDocsLog inGet started
Tessl Logo

build123d-libs

Use when standard mechanical parts, fasteners, bearings, V-slot rails, T-nuts, wheels, or linear-motion parts are needed in Build123d CAD, and always before modeling a screw into a 3D-printed part — printed screw joints must come from this skill's kit, never hand-modeled.

61

Quality

77%

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 ./reference/replicator-original/me/build123d-libs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 lean, well-sequenced body with strong validation and error-recovery structure that would score near the top if the bundle were complete. The decisive weakness is that five of nine referenced files — including both kit docs and all example recipes that the hard constraint and workflow depend on — are not present in the bundle, breaking navigation to the skill's most critical content.

Suggestions

Bundle the missing files referenced in the Reference Index: kits/printed-screw-joint-v1/KIT.md, kits/vslot-2020-corner-composite-v1/KIT.md and recipe.py, and examples/vslot-m5-stack-v1.py and vslot-bookshelf-v1.py — the Hard Constraint section is unusable without the printed-screw-joint KIT.md.

If the kits/examples are intentionally external, inline the minimal make_screw_joint_v1 call contract (parameters, strategy values, rejection semantics) into SKILL.md so the hard constraint can be followed without the missing file.

Audit every path in the Reference Index against the shipped bundle so each 'What it answers' promise is actually resolvable at use time.

DimensionReasoningScore

Conciseness

The ~40-line body is lean and assumes Claude's competence: no explanation of what Build123d, V-slot, or a heat-set insert is; directives are terse ('Do not hand-model a screw hole, boss thread, or lead-in.') and the reference index table communicates per-file purpose in one row each. Every token earns its place, matching the 5 anchor; there is no padding that would drop it to 4.

5 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: a real import ('from screwjoint import make_screw_joint_v1'), a named rejection class ('ScrewJointNotApplicableV1'), specific read targets ('references/decision-guide.md'), and copy-the-recipe instructions. It is not 5 because the actual call contract for make_screw_joint_v1 and the connection-inventory mechanics are deferred to files that are not present in the bundle, leaving minor gaps a reader cannot resolve from the body alone; it is well above 3's 'pseudocode / missing key details'.

4 / 5

Workflow Clarity

The 7-step Core Workflow is clearly sequenced and includes an explicit validation checkpoint ('assert that every intended connection is handled by a named kit or by explicit freeform source') plus an error-recovery feedback loop (kit rejection → classify 'free' → model directly, with 'A ScrewJointNotApplicableV1 rejection is the only valid reason to model a joint by hand'). This matches the 5 anchor's 'explicit validation steps; feedback loops; checklists'; the operations are constructive CAD modeling, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The body is well structured (overview, hard-constraint section, workflow, and a clear one-level-deep reference index table), but scored against the actual bundle: of the nine referenced paths, only the four references/*.md files exist — kits/printed-screw-joint-v1/KIT.md, both vslot-2020-corner-composite-v1 files, and both examples/*.py are absent. Since the Hard Constraint ('any screw fastening into a 3D-printed part') depends on the missing KIT.md, navigation to the skill's central content is broken, which is worse than the 4 anchor's 'minor organization gaps' and fits the 2 anchor's unusable-navigation end of the scale better than 3's 'could be better organized'.

2 / 5

Total

16

/

20

Passed

Description

65%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 highly specific, distinctive trigger description with an unusually strong 'when' (including the printed-screw-joint hard rule), but it describes when to fire rather than what the skill does — the capability statement is only implied by 'must come from this skill's kit'. Voice is correctly third-person and there is no fluff.

Suggestions

Open with an explicit one-clause 'what', e.g. 'Supplies standard mechanical parts (fasteners, bearings, V-slot rails, T-nuts, wheels) from pre-installed Build123d libraries, plus a printed screw-joint kit and copy-owned assembly recipes.' before the 'Use when' clause.

Add 1-2 more natural synonyms users would say (bolts, nuts, linear rails/rails) to broaden trigger coverage toward the top anchor.

State the kit/workflow deliverables (kit catalog, connection classification, example recipes) so the 'what' is explicit rather than inferred from the screw-joint rule.

DimensionReasoningScore

Specificity

The description names the domain concretely ('standard mechanical parts, fasteners, bearings, V-slot rails, T-nuts, wheels, or linear-motion parts ... in Build123d CAD') and gives one concrete action ('printed screw joints must come from this skill's kit, never hand-modeled'), but it never states what the skill actually provides (pre-installed libraries, kits, recipes, an assembly workflow). It fits 'names domain and 1-2 concrete actions, but not comprehensive'; not 4 because no list of the skill's capabilities is given, and not 2 because the domain and the screw-joint rule are far more concrete than 'Processes PDF files'.

3 / 5

Completeness

The 'when' is explicit and excellent ('Use when standard mechanical parts ... are needed in Build123d CAD, and always before modeling a screw into a 3D-printed part'), but the 'what' is only implied — 'printed screw joints must come from this skill's kit' hints at a kit without saying the skill supplies library parts, kits, and recipes. Scoring only what is explicit, this matches 'what ... missing or only weakly implied' rather than the 4 anchor where both are present; the trigger clause keeps it well above 2.

3 / 5

Trigger Term Quality

Strong natural-term coverage: 'fasteners, bearings, V-slot rails, T-nuts, wheels, linear-motion parts, screw, 3D-printed part, Build123d CAD' are all phrases a user would naturally say. It falls just short of the 5 anchor ('comprehensive coverage including synonyms') because a few common synonyms are absent (e.g., 'bolts', 'nuts' beyond T-nuts, 'linear rails', 'shaft'); clearly above 3, which requires missing common variations.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — Build123d CAD with V-slot rails, T-nuts, printed screw joints — with distinct trigger terms and minimal overlap risk with generic CAD or fastener skills. It matches the 5 anchor ('clear niche with distinct triggers; minimal conflict risk') and is far from the 4 anchor's 'minor overlap risk with closely related skills'.

5 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 6 missing, 4 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository
JimmyPang02/open-replicator
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.