CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prototype

构建一次性原型来回答一个设计问题。适用于用户想验证某个 state model 或 logic 是否感觉对,或探索 UI 应该长什么样时。

Quality

78%

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 ./skills/engineering/prototype/SKILL.md
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 and actionable body: tight rules, concrete commands, a clear branch-selection workflow with defaults, and an explicit capture step. The one significant defect is that both referenced branch files (LOGIC.md, UI.md) are missing from the bundle, leaving the skill's core branch-specific guidance dangling.

Suggestions

Ship LOGIC.md and UI.md in the skill bundle (or inline their essential content) — the body delegates each branch's build detail to files that do not exist, so following either link leads nowhere.

Add an explicit verification checkpoint before the capture step (e.g., how to confirm with the user that the design question is answered before folding the decision into real code).

Include one minimal executable skeleton (e.g., the single-HTML-file scaffold or the route-with-search-param switcher) so the launch story is copy-paste ready rather than descriptive.

DimensionReasoningScore

Conciseness

"Prototype 是用来回答一个问题的 throwaway code。问题决定形状。" — the body is dense, directive prose with zero padding; it never explains concepts Claude already knows (routing conventions, task runners are referenced, not taught). Every sentence carries instruction or decision rationale.

5 / 5

Actionability

Concrete commands and mechanics throughout: "`pnpm <name>`、`python <path>`、`bun <path>`", "URL search param 和浮动底栏", "带有清晰 'PROTOTYPE, wipe me' 名称的本地文件", "commit 到 main 之外的 throwaway branch". Not 5: no complete executable example in the body, and the branch-specific build detail is delegated to referenced files.

4 / 5

Workflow Clarity

Clear sequence: identify the question → choose a branch (with an explicit default heuristic and assumption disclosure for ambiguous cases) → apply the six common rules → capture the verdict. Rule 5 ("每次 action 或 variant switch 后,打印或渲染完整相关 state") is an explicit feedback mechanism. Not 5: the verify-before-capture checkpoint is only implied by "验证过的 decision" — how to confirm the question is answered before folding decisions into real code is not spelled out.

4 / 5

Progressive Disclosure

The two references ([LOGIC.md](LOGIC.md), [UI.md](UI.md)) are well-signaled, tied directly to the branch questions, and one level deep — but neither file exists in the bundle (no references/, scripts/, or assets/ directories, and a filesystem search finds no LOGIC.md or UI.md). The delegated branch detail is unreachable, breaking navigation despite good structure.

3 / 5

Total

16

/

20

Passed

Description

70%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 concise, well-targeted description with an explicit use-when clause and natural trigger terms covering both the logic-validation and UI-exploration branches. Its main weaknesses are an abstract 'what' that never names the actual deliverables and missing common synonyms (mockup, spike, demo).

Suggestions

State the concrete deliverables in the description (e.g., 'generates a single shareable HTML file for logic walkthroughs, or a set of UI variants on one route') to lift specificity and completeness.

Add common trigger synonyms such as 'throwaway', 'spike', 'mockup', or 'demo' so users phrasing the need differently still match the skill.

DimensionReasoningScore

Specificity

Names the domain ("构建一次性原型") and two concrete use cases ("验证某个 state model 或 logic", "探索 UI 应该长什么样"), matching 'domain plus 1-2 concrete actions'. It does not list several specific actions or state what the prototypes actually are (single HTML file, route variants), so it falls short of anchor 4.

3 / 5

Completeness

Has an explicit what ("构建一次性原型来回答一个设计问题") and an explicit when clause ("适用于用户想验证...或探索 UI 应该长什么样时") with concrete triggers. Not 5: the what remains at the abstract level of 'answer a design question' without naming the deliverables or scope of the prototypes.

4 / 5

Trigger Term Quality

Includes natural terms a user would say: "原型" (prototype), "验证" (validate), "state model", "logic", "探索 UI" — good keyword coverage. Not 5 because common synonyms and variations (mockup, spike, demo, throwaway, PoC) are missing; clearly above anchor 3's single generic keyword.

4 / 5

Distinctiveness Conflict Risk

The "一次性原型" (one-off prototype) niche with design-question triggers (validate state model feel, explore UI) is mostly distinct from production coding skills. Not 5: generic requests like 'build me a quick demo' could overlap with general web-development skills.

4 / 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: 2 missing

Warning

Total

15

/

16

Passed

Repository

vinvcn/mattpocock-skills-zh-CN

Path

skills/engineering/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.