Specification Contradiction Checker

Detect specification contradictions and inconsistencies across markdown documents.

Updated Dec 9, 2025
One-click install
npx skills add https://github.com/teliha/dev-workflows --skill specification-contradiction-checker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Specification Contradiction Checker
Source: https://github.com/teliha/dev-workflows/tree/main/skills/check-spec-contradictions
Command: npx skills add https://github.com/teliha/dev-workflows --skill specification-contradiction-checker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents expensive rework by systematically analyzing all specification files for contradictions, inconsistencies, and ambiguities.

Core Features & Use Cases

  • Contradiction Detection: Identify directly conflicting statements across specifications.
  • Inconsistency Analysis: Find varying descriptions of the same concepts in different documents.

Quick Start

Check all specifications for contradictions Review the specs in specs/api/ for inconsistencies Before I implement this feature, check if the specs are consistent.

Frequently Asked Questions about Specification Contradiction Checker

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

FAQPage Schema
How do I find contradictions across multiple specification documents?

Specification contradiction detection systematically analyzes all spec files to identify directly conflicting statements, inconsistent descriptions of the same concepts, and ambiguities across documents. Run the Skill against your specs/ directory to generate a structured report categorizing each contradiction with findings and recommendations.

What kinds of inconsistencies can specification analysis detect?

Analysis detects direct contradictions, varying descriptions of identical concepts, ambiguous language, missing information, and cross-reference issues within and across specification files. The Skill extracts key statements and terms, compares them across documents, and flags conflicts before implementation begins.

Can I check specifications for consistency before implementing a feature?

Yes. Run contradiction detection on your specification files before development to identify conflicts and ambiguities. This prevents costly rework by surfacing inconsistencies early, allowing you to resolve them during the planning phase rather than during implementation.

How does specification contradiction checking support parallel analysis?

The Skill supports parallel multi-file analysis, enabling simultaneous review of multiple specification documents. This accelerates inconsistency detection across large documentation sets and supports automated activation on spec reviews for continuous quality assurance.

What output does a specification contradiction report include?

The report provides structured contradiction analysis with categories, specific findings, actionable recommendations, and follow-up questions. Results highlight conflicting statements, inconsistent terminology, and gaps, organized for easy resolution and documentation updates.

Should I use specification analysis for markdown documentation files?

Yes. The Skill analyzes specification and documentation in multiple formats including markdown files and requirements documents. It's designed for any text-based specification format in your specs/ directory to catch inconsistencies across all documentation types.

Related Skills