ambiguity-auditor

Audit knowledge base content for undefined terms, contradictions, and stale material.

2|2|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/mathiasbourgoin/roster --skill ambiguity-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ambiguity-auditor
Source: https://github.com/mathiasbourgoin/roster/tree/main/.opencode/skills/ambiguity-auditor
Command: npx skills add https://github.com/mathiasbourgoin/roster --skill ambiguity-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unaddressed ambiguity, undefined terms, vague requirements, contradictions, and stale content in knowledge bases lead to team misalignment, incorrect implementations, and wasted rework during software development.

Core Features & Use Cases

  • Term & Ambiguity Validation: Scans all KB files to flag undefined domain terms, inconsistent term usage against the glossary, and vague unquantified requirements with suggested measurable replacements.
  • Cross-File Consistency Checks: Cross-references claims across KB files to detect contradictions between specs, architecture docs, and glossary definitions, plus missing cross-references to related concepts.
  • Staleness Detection: Flags KB files not updated in over 30 days and references to removed codebase components to keep documentation current.
  • Use Case: A product engineering team can run this audit before a major feature release to catch misaligned specs and undefined terms that would cause developer confusion and delayed delivery.

Quick Start

Use the ambiguity-auditor skill to scan your project's knowledge base and generate a full report of all ambiguity, contradiction, and staleness issues.

Frequently Asked Questions about ambiguity-auditor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my knowledge base for contradictions and undefined terms?

To check a knowledge base for contradictions and undefined terms, you can audit your specification files and glossary entries to identify vague requirements and cross-file inconsistencies. This process scans all files to flag undefined domain terms and inconsistent usage against the glossary.

What is documentation staleness detection and when do I need it?

Documentation staleness detection flags knowledge base files not updated in over 30 days and identifies references to removed codebase components. You need it before major feature releases to catch misaligned specs and outdated material that cause developer confusion and delayed delivery.

How do I audit cross-file consistency in specification markdown files?

To audit cross-file consistency in specification markdown files, cross-reference claims across architecture docs and glossary definitions to detect contradictions. This validates cross-spec entity consistency and identifies missing cross-references to related concepts.

Can I use this to validate unquantified requirements in engineering specs?

Yes, you can validate unquantified requirements in engineering specs. The audit scans knowledge base files to flag vague unquantified requirements and provides suggested measurable replacements to ensure clear, testable criteria for product and engineering teams.

Does this knowledge base audit work without external dependencies?

Yes, the knowledge base audit works without external dependencies. It directly scans your structured knowledge base files including glossary entries and specification markdown files to generate a structured severity-ranked report of all findings with specific remediation recommendations.