CtrlK
BlogDocsLog inGet started
Tessl Logo

ask-questions-if-underspecified

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

70

1.56x
Quality

58%

Does it follow best practices?

Impact

86%

1.56x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tests/ext_conformance/artifacts/agents-mikeastock/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 well-structured, actionable instruction-only skill: a clear four-step workflow with explicit pause-and-confirm checkpoints, concrete question templates, and a usable reply-format example. Weaknesses are minor — some soft hedged directives and no handling for still-ambiguous answers after the first pass.

Suggestions

Add a short fallback step for when answers conflict or the request is still underspecified after the first pass (e.g., ask one targeted follow-up or state remaining assumptions).

Tighten step 2's formatting instructions (bolding, "Recommended" tagging) into a single compact rule to reduce token overhead.

Replace hedged directives like "when helpful" and "if that reduces friction" with concrete criteria or drop them.

DimensionReasoningScore

Conciseness

The body is mostly lean — a tight checklist of underspecification signals, compact question templates, and one example block — with only minor over-explanation, such as the detailed bolding and "Recommended"-tagging formatting instructions in step 2. It is not score 5 because a few of those formatting details could be trimmed, and not score 3 because there is no real padding of concepts Claude already knows.

4 / 5

Actionability

Guidance is concrete and directly usable: numbered question templates, a copy-paste-ready example with a compact reply format ("Reply with: defaults (or 1a 2a)"), fast-path acceptance, and "Not sure - use default" options. It is not score 5 because a few directives remain soft (e.g., "if that reduces friction", "when helpful") without concrete criteria.

4 / 5

Workflow Clarity

The four-step workflow is clearly sequenced with real checkpoints: pause before acting, state assumptions and ask for confirmation before proceeding, and restate requirements before starting work. It is not score 5 because there is no guidance for the error-recovery case where answers conflict or the request remains underspecified after the first pass; it is clearly above anchor 3 since the checkpoints are explicit rather than implicit.

4 / 5

Progressive Disclosure

The skill is self-contained with well-organized sections (Goal, Workflow, Question templates, Anti-patterns) and no external references, which is appropriate since no content warrants a separate file. It is not score 5 because the body slightly exceeds the ~50-line simple-skill threshold and the question-templates section could be tightened, leaving minor organization gaps per anchor 4.

4 / 5

Total

16

/

20

Passed

Description

42%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 states a single concrete action and an explicit negative invocation rule, but lacks natural trigger terms and a positive 'Use when...' clause. As a result it is neither discoverable by keyword nor fully explicit about when it applies.

Suggestions

Add a positive trigger clause, e.g., "Use when a request is ambiguous or underspecified, or when the user asks to clarify scope, requirements, or acceptance criteria before implementation."

Enumerate the concrete actions the skill performs, e.g., "Ask a small numbered set of clarifying questions with recommended defaults, pause implementation until answered, and restate requirements before starting work."

Include natural user phrasings and synonyms (underspecified, ambiguous, unclear requirements, missing acceptance criteria) so the skill is discoverable by keyword.

DimensionReasoningScore

Specificity

"Clarify requirements before implementing" names one concrete action but stops there, matching the anchor for domain plus 1-2 concrete actions without comprehensive coverage. It is not score 4 because it does not list several specific actions (e.g., asking clarifying questions, pausing implementation), and not score 2 because the action stated is concrete rather than purely generic.

3 / 5

Completeness

The 'what' is present but vague ("Clarify requirements before implementing"), and the 'when' exists only as a negative invocation rule ("Do not use automatically, only when invoked explicitly") with no positive 'Use when...' clause, which caps completeness at 3 per the judging guidelines. It is not score 2 because both a what and a weak when are stated, and not score 4 because the when is exclusionary rather than a concrete positive trigger.

3 / 5

Trigger Term Quality

The only keyword is the generic phrase "Clarify requirements"; natural phrases a user would say ("underspecified", "ambiguous request", "requirements are unclear") and their synonyms are entirely missing. It is not score 1 because the phrase is user-recognizable rather than pure technical jargon, but it falls short of score 3's 'some relevant keywords' since there is effectively one generic term.

2 / 5

Distinctiveness Conflict Risk

"Clarify requirements" is somewhat specific to the requirements-clarification niche but could still overlap with planning, discovery, or scoping skills. The explicit-invocation-only clause reduces auto-trigger conflict, keeping it above anchor 2, but the broad core phrase prevents the 'mostly distinct' fit of anchor 4.

3 / 5

Total

11

/

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
Dicklesworthstone/pi_agent_rust
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.