CtrlK
BlogDocsLog inGet started
Tessl Logo

ask-questions-if-underspecified

Clarify requirements before implementing. Do not use automatically, only when invoked explicitly.

58

Quality

67%

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/ask-questions-if-underspecified/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, lean, and highly actionable instruction-only skill: it sequences a clear workflow with gating checkpoints, supplies copy-paste-ready question mechanics, and stays self-contained with good organization. There is little to improve.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it lists what to define (objective, done, scope, constraints) without explaining those concepts, and every section earns its place; the minor overlap between question templates and the worked example is not enough to drop it from 'lean and efficient'.

3 / 3

Actionability

It gives copy-paste-ready guidance: numbered questions with lettered options, an explicit reply format ('Reply with: defaults (or 1a 2a)'), a fast-path mechanism, concrete templates, and anti-patterns — fully actionable for an instruction-only skill.

3 / 3

Workflow Clarity

A clear 4-step sequence (Decide, Ask, Pause, Confirm) with explicit gates — the 'Pause before acting' step blocks action until answers arrive, and the proceed-without-answers branch supplies a state-assumptions-then-confirm feedback loop.

3 / 3

Progressive Disclosure

No bundle files exist and the skill is self-contained with well-organized sections (Goal, Workflow, Question templates, Anti-patterns), which satisfies the 'no need for external references' allowance for a clear, well-sectioned single-purpose skill.

3 / 3

Total

12

/

12

Passed

Description

35%

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 conveys the skill's purpose concisely but lacks natural user-facing trigger terms and an explicit 'Use when...' clause, leaving the 'when to use' only implied. It is adequate but generic enough to risk overlap with general assistant behavior.

Suggestions

Add an explicit 'Use when...' clause naming the natural user cues that should trigger this skill (e.g., 'Use when a request is vague or could be interpreted multiple ways').

Replace internal framing with trigger terms a user would actually say (e.g., 'underspecified', 'ambiguous', 'not sure what you want').

Concretize the action with a short specific verb list (e.g., 'Ask 1-5 targeted clarifying questions and confirm assumptions before implementing').

DimensionReasoningScore

Specificity

"Clarify requirements before implementing" names the action domain but stays abstract; it does not list multiple concrete actions like the score-3 anchor, so it sits at 'names domain and some actions, but not comprehensive'.

2 / 3

Completeness

It states what the skill does but lacks an explicit 'Use when...' trigger; the 'when' is only implied via the negative 'Do not use automatically, only when invoked explicitly', which caps completeness at 2 per the guidelines.

2 / 3

Trigger Term Quality

The description contains no natural keywords a user would actually say when needing this skill; "clarify requirements" is internal framing rather than user speech, and the rest is invocation meta-instruction.

1 / 3

Distinctiveness Conflict Risk

"Clarify requirements" is a meta-skill that overlaps with general assistant behavior and could apply broadly, though the explicit invocation restriction narrows it; it is somewhat specific but could still overlap with similar skills.

2 / 3

Total

7

/

12

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.

Validation15 / 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
MoizIbnYousaf/Ai-Agent-Skills
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.