critical-analyst

What problem does it solve?

This Skill identifies contradictions, ambiguities, inconsistencies, and logical gaps in any text, code, specification, or combined artifacts, then provides concrete, actionable suggestions to fix each issue. It helps teams avoid misunderstandings, reduce implementation bugs, and improve documentation clarity by surfacing problems a reader might miss.

Core Features & Use Cases

• Cross-artifact comparison: Compare code against specifications or requirements to find mismatches (e.g., behavior vs. documented contract).
• Document QA: Review requirements, architecture notes, tutorials, and policies for vague language, undefined thresholds, and missing steps.
• Structured remediation: Produce a prioritized report that includes location, quoted evidence, problem category, impact, and a suggested fix.
• Use case: Run on a spec + implementation pair to deliver a report enumerating contradictions, naming inconsistencies, and the missing validation rules needed for correct implementation.

Quick Start

Analyze the provided document(s) and return a Critical Analysis Report listing contradictions, ambiguities, inconsistencies, and logical gaps with concrete suggested fixes for each item.