CtrlK
BlogDocsLog inGet started
Tessl Logo

discovery-question-form

Structured clarification form for unresolved material requirements.

53

Quality

60%

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 ./plugins/_official/atoms/discovery-question-form/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a well-crafted, instruction-only protocol spec: a complete executable example, exhaustive field semantics, clear activation boundaries, and an explicit convergence condition. Its weaknesses are minor — a slightly convoluted default-field paragraph and no explicit handling of invalid or partial form submissions — and its single-file organization is appropriate for its size.

DimensionReasoningScore

Conciseness

The body is dense specification where nearly every token earns its place: the activation boundary bullets ('A first turn or new project does not by itself require a form'), the full field spec, and the convergence condition are all non-obvious information Claude cannot infer. Minor trimming opportunities exist — the `default` bullet spans a second, awkwardly-joined paragraph ('Prefill each non-visual question suitable for a recommendation; omit `default` only when...') that could be consolidated, and 'A reference file remains unanswered until supplied' is cryptic. Not score 5 because of these small over-explanations; not score 3 since the padding is minor, not whole unnecessary explanations.

4 / 5

Actionability

The emission shape includes a complete, copy-paste-ready `<question-form>` JSON example covering the common control types (checkbox with maxSelections, radio with object options, select with grouped language values, file), and the question-object section exhaustively specifies every field: 'id', 'label', the enumerated 17 `type` values, `default` value semantics per control type, `options` formats, `allowCustom`, `customLabel`, and `required`. Concrete rules like 'Choose `radio` vs `select` by option count' and 'Keep each `label` under ~40 characters' make the guidance fully executable.

5 / 5

Workflow Clarity

The protocol has a clear implicit sequence: Activation boundary (when to emit) → Emission shape (how to emit) → Convergence (completion condition: 'completes when the next user message contains an answer for every required question', with the follow-up rule 'do not ask the same questions again unless later input invalidates an answer'). This is an instruction-only skill with no destructive or batch operations, so no validation cap applies. Score 5 would require explicit feedback-loop handling for edge cases such as invalid or partially-answered submissions, which is only implied.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), so the skill is a single self-contained document with well-organized sections (Activation boundary, Emission shape, Question object shape, Convergence) and no nested or buried references. The ~130-line body is cohesive spec rather than content that clearly belongs in separate files. Score 5 is reserved for well-organized skills under 50 lines or with clearly split one-level-deep references; at this length the question-object field spec could arguably live in a reference file, keeping it at 4.

4 / 5

Total

17

/

20

Passed

Description

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

The description is short and names a specific artifact, but it reads as an internal spec label rather than a trigger-oriented skill description. It lacks any 'Use when' guidance and natural trigger terms, so it would rarely be surfaced by a user's actual phrasing.

Suggestions

Add an explicit trigger clause, e.g. 'Use when material requirements are unresolved and clarification would change the design direction' — this alone would lift completeness from 3 to 4-5.

Include natural user phrasings as trigger terms, such as 'clarify requirements', 'gather brief details', or 'ask clarifying questions', instead of only the jargon phrase 'unresolved material requirements'.

State concrete actions in third person (e.g. 'Renders a structured question form with recommended defaults and processes the submitted answers') to raise specificity from naming a domain to listing what the skill actually does.

DimensionReasoningScore

Specificity

The description names the domain — "Structured clarification form" — but offers only a minimal, generic action; it describes an artifact ("a form") rather than concrete actions Claude performs. This matches the anchor 'Names the domain but actions are minimal or generic' ("Processes PDF files"), not score 3, which requires 1-2 concrete actions, and not score 1, since the domain is at least named specifically.

2 / 5

Completeness

The 'what' is fairly clear (a structured clarification form for unresolved material requirements), but there is no 'Use when...' clause or any trigger guidance — the 'when' is entirely absent. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3; score 4 would require at least a weakly explicit 'when'.

3 / 5

Trigger Term Quality

Keywords are mostly technical jargon: "unresolved material requirements" is spec-speak users would not naturally say; "clarification" is the only semi-natural term. This sits between 'no natural keywords; only technical jargon' (1) and 'some relevant keywords but missing common variations' (3) — it has one or two generic keywords but misses natural phrases like 'ask questions', 'gather requirements', 'brief', or 'clarify'.

2 / 5

Distinctiveness Conflict Risk

"Structured clarification form" carves out a somewhat specific niche (question forms during discovery), but the generic terms 'clarification' and 'requirements' could overlap with other discovery, planning, or requirements-gathering skills. It is more specific than 'Works with document files' (3) but lacks the distinct trigger phrases needed for 4-5.

3 / 5

Total

10

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
nexu-io/open-design
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.