CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

breadboarding

This skill should be used when shaping a software change and needing to breadboard the solution at the right level of abstraction (places, affordances, connections), including mapping an existing system via UI + code affordances, producing a wiring diagram, a parts/BOM plan, a fit check, and (when relevant) an extract-vs-duplicate analysis.

68

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

85%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 instruction skill: a crisp nine-step workflow with stop conditions, a built-in fit-check validation step, an error-recovery path for diagram rendering, and an exemplary progressive-disclosure layout with real, well-placed bundle files. The remaining room is minor: trim environment-specific renderer notes into a reference and add a concrete invocation example for the bundled helper script.

Suggestions

Add a one-line usage example for scripts/render_mermaid_from_edges.py (input JSON edge-list shape and command line), so the helper is immediately usable without reading the script.

Move the SVG renderer compatibility note (Zed, CSS variables, color-mix) and the naming-convention details into the wiring diagram template or a reference file, keeping the step itself to the required outputs.

Include one sample affordance row (U1/N1) inline in steps 3-4 so table format is unambiguous even before opening the templates.

DimensionReasoningScore

Conciseness

The body is largely lean — tight bullet lists, well-chosen stop conditions ("Stop when the flow answers these shaping questions"), and it assumes Claude's competence throughout. Minor over-explanation that could be trimmed or pushed to references: the renderer compatibility note ("Some Markdown/SVG renderers (for example Zed) do not fully support CSS variables..."), the naming-convention details, and a slight restatement of affordance concepts between the Purpose section and step 1. This matches anchor 4 ('minor instances of over-explanation that could be trimmed') rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Concrete, executable instruction-level guidance throughout: numbered field lists for each affordance type, a required dual-output format for the diagram (Mermaid source + static SVG + ASCII fallback), explicit template paths per step, and a quality bar with checkable rules. It falls short of anchor 5 only in small gaps — e.g., no sample invocation of scripts/render_mermaid_from_edges.py (no command line or input JSON shape shown) and no inline mini-example of a table row, both of which are deferred to bundle files. Anchor 3 is ruled out because the guidance is concrete and specific, not pseudocode or high-level hints.

4 / 5

Workflow Clarity

Nine clearly sequenced steps with explicit stop conditions (step 2's "Stop when the flow answers these shaping questions"), an embedded validation checkpoint (step 7's fit check surfacing unsolved requirements and the decision type needed), an error-recovery loop ("If the render appears as black blocks, post-process the SVG..."), and a closing quality-bar checklist. No destructive or batch operations exist, so no validation cap applies; this matches anchor 5 rather than anchor 4 (which requires missing checkpoints).

5 / 5

Progressive Disclosure

A clear overview body (~210 lines) with well-signaled, one-level-deep references: every cited path (references/templates/breadboard-pack-template.md, wiring-diagram-mermaid-template.md, parts-bom-template.md, fit-check-template.md, extract-vs-duplicate-template.md, references/shapeup-breadboarding-notes.md, references/examples/letter-search-example.md, scripts/render_mermaid_from_edges.py) exists in the bundle, is referenced at the exact step where it is needed, and is cataloged in a final "Bundled resources" section. Content is appropriately split: templates and examples live outside the body; only the decision rules stay inline. This matches anchor 5; anchor 4's 'minor organization gaps' are absent.

5 / 5

Total

18

/

20

Passed

Description

80%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 that clearly states the skill's purpose, enumerates its concrete deliverables, and includes an explicit trigger clause. Its main weaknesses are a partially circular when-clause built on the skill's own jargon and missing natural synonyms that users might say when they need this skill.

Suggestions

Rewrite the when-clause to use concrete external trigger phrases instead of the skill's own coinage, e.g., "Use when the user asks to breadboard, shape, or sketch a change at the system level, map what an existing system does, or decide whether to extract vs duplicate shared logic."

Add natural synonyms users might say — e.g., "wiring diagram, flow diagram, parts list, bill of materials, reuse analysis" — to broaden trigger-term coverage.

Clarify that the wiring-diagram output is a system/flow topology diagram (not general-purpose diagramming) to reduce conflict with generic diagramming skills.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete deliverables — "mapping an existing system via UI + code affordances, producing a wiring diagram, a parts/BOM plan, a fit check, and (when relevant) an extract-vs-duplicate analysis" — giving comprehensive, action-level coverage of the skill's outputs. No neighboring anchor fits better: score 4 requires 'minor gaps in coverage', but every major capability of the skill body is represented.

5 / 5

Completeness

Both what and when are explicitly present: "This skill should be used when shaping a software change and needing to breadboard the solution...". However the when-clause is partially circular — it triggers on the skill's own coinage ("breadboard the solution") rather than concrete external trigger phrases (e.g., 'when the user asks to breadboard, map system affordances, or plan parts'), so it matches anchor 4 ('when could be more explicit or specific') rather than anchor 5.

4 / 5

Trigger Term Quality

Good natural keywords for the target audience — "shaping a software change", "breadboard", "wiring diagram", "parts/BOM plan", "fit check" — but common synonyms and variations (e.g., "wireframe-free sketch", "rough out", "architecture diagram", "plan the parts") are absent. It is above anchor 3 ('some relevant keywords but missing common variations') but short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The Shape Up vocabulary ("breadboard", "places, affordances, connections", "fit check", "extract-vs-duplicate") carves a clear niche with minimal overlap, but "producing a wiring diagram" carries minor overlap risk with general diagramming/mermaid skills. Mostly distinct with minor overlap risk, matching anchor 4; anchor 5 would require no meaningful conflict surface.

4 / 5

Total

17

/

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

referenced_paths_exist

Referenced path issues: 7 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

marchatton/agent-skills

Path

.agents/skills/02-shape/breadboarding/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.