critical-analyst

Analyze texts, code, and specifications to surface contradictions and logical gaps.

22|5|Updated Aug 18, 2025
One-click install
npx skills add https://github.com/glaucia86/mba-ai-fullcycle --skill critical-analyst
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: critical-analyst
Source: https://github.com/glaucia86/mba-ai-fullcycle/tree/main/.agents/skills/critical-analyst
Command: npx skills add https://github.com/glaucia86/mba-ai-fullcycle --skill critical-analyst

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about critical-analyst

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

FAQPage Schema
How do I check code against specifications to find contradictions and mismatches?

Cross-artifact comparison detects contradictions between code and specifications by analyzing paired artifacts. It produces a prioritized report citing quoted evidence, explaining inconsistencies, and providing concrete remediation suggestions to ensure correct implementation.

What is the best way to identify ambiguities and undefined thresholds in requirements documents?

Critical analysis of requirements documents identifies ambiguities, undefined thresholds, and missing steps through deep text review. It generates a categorized report with quoted evidence, impact assessment, and actionable fixes to improve documentation clarity.

How do I perform critical analysis on architecture notes and step-by-step tutorials?

Document QA reviews architecture notes and tutorials to surface logical gaps, vague language, and inconsistencies. The analysis outputs a structured report prioritized by severity, detailing locations, problem categories, and concrete suggestions to fix implementation issues.

Can I detect logical gaps and missing validation rules in a specification and implementation pair?

Yes, analyzing specification and implementation pairs identifies logical gaps, naming inconsistencies, and missing validation rules. The resulting critical analysis report enumerates contradictions and provides prioritized, concrete remediation suggestions for correct implementation.

Does critical analysis require any specific dependencies or components to run?

No dependencies or components are required to perform critical analysis on texts, code, and specifications. The skill operates independently to surface contradictions, ambiguities, and logical gaps, producing a categorized report with actionable fixes.

How do I get a structured remediation report for inconsistencies found in my code review?

Critical analysis generates a structured remediation report by categorizing inconsistencies, quoting evidence, and explaining problems. It prioritizes suggested fixes by severity, helping teams reduce implementation bugs and resolve documentation misunderstandings.