CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prototype

Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.

Quality

84%

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

The canonical home for this skill is prototype in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

An exceptionally lean, opinionated, and actionable body with a sound branch-based structure and a clear capture workflow. Its main defects are the missing LOGIC.md and UI.md bundle files — which make the primary navigation links dangling — and the absence of any validation checkpoint confirming the prototype answered its question before capture.

Suggestions

Add the referenced LOGIC.md and UI.md bundle files (or remove the links and inline minimal guidance for each branch) — the body's two primary references currently point to files that do not exist in the bundle.

Add an explicit validation checkpoint before the capture step, e.g. confirm the prototype answered the design question and surface the verdict to the user before committing to the throwaway branch.

Include a minimal starter snippet or file-naming example for each branch's artifact (the single HTML logic demo and the multi-variant UI route) to close the remaining actionability gap.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — every sentence adds non-obvious information ("The question decides the shape", "Persistence is the thing the prototype is _checking_, not something it should depend on", "The main branch keeps only the validated decision"). There is no padding and no explanation of concepts Claude already knows, matching the top anchor.

5 / 5

Actionability

Concrete, executable guidance throughout: specific artifact forms ("a single shareable HTML file (free-play buttons plus tabbed guided walkthroughs)", "several radically different UI variations on a single route, switchable via a URL search param and a floating bottom bar"), concrete run commands ("pnpm <name>", "python <path>", "bun <path>"), and a specific capture procedure. It is not a 5 because no starter scaffold or code snippet is provided for the two artifact types, leaving minor execution gaps.

4 / 5

Workflow Clarity

The sequence is clear: identify the question, pick a branch (with an explicit ambiguity fallback rule and an instruction to state the assumption), apply the six rules, then capture. Checkpoints are mostly present — the branch-selection decision rule acts as an early guard — but there is no explicit validation step confirming the prototype actually answered the question before capture, which keeps it below the 5 anchor.

4 / 5

Progressive Disclosure

The structure is well designed — a short overview that branches to two clearly-signaled, one-level-deep references ([LOGIC.md](LOGIC.md) and [UI.md](UI.md)) — but neither referenced file exists in the skill bundle (no references/, scripts/, assets/, or top-level LOGIC.md/UI.md are present). Per the guideline to score against the actual bundle structure, the branch destinations are dangling, so navigation to the core branch content fails.

3 / 5

Total

16

/

20

Passed

Description

83%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: explicit what-and-when structure with natural trigger phrases and a clearly demarcated prototyping niche. Minor room to grow via trigger synonyms (mockup, spike, proof of concept) and slightly fuller capability coverage.

DimensionReasoningScore

Specificity

The description names a concrete action ("Build a throwaway prototype to answer a design question") and enumerates two specific capability scopes ("sanity-check whether a state model or logic feels right", "explore what a UI should look like"), matching the 'several specific actions with minor gaps' anchor. It is not a 5 because it stops short of comprehensively covering what the prototype artifacts are (e.g., the HTML logic demo or multi-variant UI route described in the body).

4 / 5

Completeness

It explicitly answers both questions: what ("Build a throwaway prototype to answer a design question") and when ("Use when the user wants to sanity-check... or explore what a UI should look like") with concrete trigger phrases, matching the top anchor. Not below 5 because neither half is vague or merely implied.

5 / 5

Trigger Term Quality

Natural trigger phrases are present — "prototype", "sanity-check", "whether a state model or logic feels right", "explore what a UI should look like" — phrasings a user would plausibly say. It falls short of the 5 anchor because common synonyms like "mockup", "spike", "proof of concept", or "wireframe" are absent.

4 / 5

Distinctiveness Conflict Risk

The throwaway-prototype niche is clear and the two triggers are distinctive, but "explore what a UI should look like" has minor overlap risk with general UI-design or mockup-generation skills, fitting the 'mostly distinct; minor overlap risk' anchor rather than the minimal-conflict 5 anchor.

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

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

tonykay/transcriber

Path

.agents/skills/prototype/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.