CtrlK
BlogDocsLog inGet started
Tessl Logo

ask-questions-if-underspecified

Clarify requirements before implementing. Use when serious doubts arise.

56

Quality

64%

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

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

The body is a lean, well-structured instruction skill with highly actionable templates, a clear gated workflow, and good organization. Its main weakness is minor redundancy and being slightly long for a single-purpose skill.

DimensionReasoningScore

Conciseness

The body is list-driven and assumes Claude's competence without explaining known concepts; the only slack is minor redundancy between the "Question templates" section and step 2's bullet list.

4 / 5

Actionability

It provides concrete, copy-paste-ready guidance: numbered questions, lettered options, a "reply defaults" fast-path, and a worked example block with a 1a 2a reply format; minor gaps keep it just short of fully exhaustive coverage.

4 / 5

Workflow Clarity

A clear 4-step sequence (decide, ask, pause, confirm) with explicit gates and a confirm/correct feedback loop; the operation is non-destructive so no cap applies, but checkpoints could be slightly more explicit.

4 / 5

Progressive Disclosure

Content is well-organized into clearly labeled sections (When to Use, When NOT to Use, Goal, Workflow, templates, anti-patterns, limitations) and is self-contained with no external references needed; at ~85 lines it is just outside the simple-skill 5-anchor range.

4 / 5

Total

16

/

20

Passed

Description

53%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 cleanly covers both the what and when but stays high-level, naming a single generic action and a somewhat formal trigger phrase. It is functional yet lacks the concrete, natural-language specificity that would make it distinctive.

Suggestions

Enumerate concrete actions the skill performs, e.g. "Ask 1-5 numbered clarifying questions with multiple-choice options and defaults before implementing."

Swap "serious doubts arise" for natural user-facing triggers such as "when the request is ambiguous, underspecified, or has multiple plausible interpretations".

Add a distinguishing cue so it does not compete with general planning skills, e.g. framing it as a pre-implementation clarification gate.

DimensionReasoningScore

Specificity

The description states only one generic action ("Clarify requirements before implementing") with no enumeration of concrete capabilities, placing it below the 3-anchor which expects 1-2 concrete actions.

2 / 5

Completeness

It explicitly answers both what ("Clarify requirements before implementing") and when ("Use when serious doubts arise"), but the when-clause could be more specific about the triggering situations.

4 / 5

Trigger Term Quality

"Use when serious doubts arise" supplies a relevant trigger keyword ("doubts") but uses formal phrasing and misses natural variations users actually say ("not sure", "ambiguous", "underspecified").

3 / 5

Distinctiveness Conflict Risk

The clarification niche is identifiable but the generic phrasing ("requirements", "serious doubts") could overlap with other reasoning or planning skills.

3 / 5

Total

12

/

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.

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
sickn33/agentic-awesome-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.