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-detector100
Quality
100%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Table of Contents
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.