consistency-check

Cross-reference BDD feature files, OpenSpec specifications, and documentation for contradictions.

9|2|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/typemd/typemd --skill consistency-check-typemd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: consistency-check
Source: https://github.com/typemd/typemd/tree/main/.claude/skills/consistency-check
Command: npx skills add https://github.com/typemd/typemd --skill consistency-check-typemd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drift between BDD feature files, OpenSpec specifications, and documentation creates hidden contradictions and terminology mismatches that can lead to bugs, confused users, and wasted effort.

Core Features & Use Cases

  • Cross‑reference BDD scenarios with OpenSpec requirements and documentation to surface behavioral inconsistencies.
  • Terminology audit using the project glossary to ensure uniform naming across English and zh‑tw docs.
  • Coverage triage (optional) that examines Go source code to classify gaps as untested, missing, or implemented differently.
  • Use case: Before a major release, run the skill to verify that all relational features described in the spec are exercised by tests and accurately reflected in the user guide.

Quick Start

Ask the consistency-check skill to compare all features, specs, and documentation for mismatches.

Frequently Asked Questions about consistency-check

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

FAQPage Schema
How do I check for contradictions between BDD scenarios and OpenSpec specifications?

To check for contradictions between BDD scenarios and OpenSpec specifications, cross-reference Gherkin feature files against requirements and glossary terms to surface behavioral inconsistencies and terminology mismatches across the codebase.

What is documentation drift and how does it affect BDD feature files?

Documentation drift is the gradual mismatch between BDD feature files, OpenSpec specifications, and project docs, which introduces hidden behavioral contradictions and terminology inconsistencies that lead to bugs and confused users.

How do I audit terminology consistency across English and zh-tw documentation?

You audit terminology consistency by parsing the project glossary and cross-referencing its terms against English and zh-tw documentation, ensuring uniform naming conventions across all project files.

Can I triage test coverage gaps by analyzing Go source code?

Yes, you can optionally triage coverage gaps by analyzing Go source code alongside BDD scenarios and OpenSpec specifications, classifying coverage gaps as untested, missing, or implemented differently.

When should I run a cross-reference consistency check before a release?

You should run a cross-reference consistency check before a major release to verify that relational features described in the spec are exercised by tests and accurately reflected in the user guide.

Does consistency-check work without external dependencies or additional components?

Yes, consistency-check operates independently without external dependencies or components, parsing Markdown, Gherkin, and glossary files directly to generate a structured contradiction report.