CtrlK
BlogDocsLog inGet started
Tessl Logo

ambiguity-detector

Detects ambiguity in natural-language requirements — weak words, dangling references, underspecified quantities, conflicting interpretations — before they become implementation bugs. Use when reviewing requirements, when a spec uses words like "appropriate" or "fast", or when two engineers read the same requirement and built different things.

Install with Tessl CLI

npx tessl i github:santosomar/general-secure-coding-agent-skills --skill ambiguity-detector
What are skills?

100

Quality

100%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SKILL.md
Review
Evals

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that hits all the marks. It provides specific concrete capabilities (detecting weak words, dangling references, underspecified quantities, conflicting interpretations), includes natural trigger terms users would actually say, has an explicit 'Use when...' clause with multiple scenarios, and carves out a distinct niche that won't conflict with other skills. The description uses proper third person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Detects ambiguity', identifies 'weak words, dangling references, underspecified quantities, conflicting interpretations'. Provides concrete examples of what it catches.

3 / 3

Completeness

Clearly answers both what (detects ambiguity in requirements with specific types listed) AND when (explicit 'Use when...' clause with multiple trigger scenarios: reviewing requirements, specs with vague words, conflicting interpretations).

3 / 3

Trigger Term Quality

Includes natural keywords users would say: 'requirements', 'spec', 'appropriate', 'fast'. The phrase 'two engineers read the same requirement and built different things' captures a real-world scenario users would describe.

3 / 3

Distinctiveness Conflict Risk

Clear niche focused specifically on requirements ambiguity detection. Distinct from general code review, documentation, or other analysis skills. The specific focus on 'weak words', 'dangling references', and 'underspecified quantities' creates a unique trigger profile.

3 / 3

Total

12

/

12

Passed

Implementation

100%

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

This is an excellent skill that efficiently teaches a specific, valuable capability. The taxonomy table provides quick reference, the two-interpretations test gives a concrete decision procedure, and the worked example demonstrates complete application. The 'Do not' section prevents common mistakes without being preachy.

DimensionReasoningScore

Conciseness

Every section earns its place. The taxonomy table is dense and useful, the worked example demonstrates without padding, and there's no explanation of concepts Claude already knows. The 'Do not' section efficiently prevents common mistakes.

3 / 3

Actionability

Highly actionable with concrete taxonomy, the two-interpretations test as a clear decision procedure, a fully worked example showing exact analysis, and a specific output format template. Claude can immediately apply this to any requirement.

3 / 3

Workflow Clarity

The workflow is implicit but crystal clear: scan for signal words → apply two-interpretations test → generate structured output with questions and template. The worked example demonstrates the complete process with validation (checking context-dependent false positives).

3 / 3

Progressive Disclosure

Well-organized with clear sections progressing from taxonomy → test → example → caveats → output format. At ~100 lines, appropriately self-contained. References to 'requirement-enhancer' skill shows awareness of skill ecosystem without deep nesting.

3 / 3

Total

12

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

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.