critical-analysis

Analyze technical arguments and engineering proposals for logical gaps and assumptions.

Updated Nov 30, 2018
One-click install
npx skills add https://github.com/guygrigsby/dotfiles --skill critical-analysis-guygrigsby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: critical-analysis
Source: https://github.com/guygrigsby/dotfiles/tree/main/opencode/skills/critical-analysis
Command: npx skills add https://github.com/guygrigsby/dotfiles --skill critical-analysis-guygrigsby

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rigorous adversarial analysis identifies logical gaps, unexamined assumptions, edge cases, and conceptual weaknesses in technical arguments and engineering proposals, helping teams strengthen designs before implementation.

Core Features & Use Cases

  • Structured critique framework that guides you from understanding the strongest version of an argument to exposing gaps in premises and assumptions.
  • Multi-phase analysis including Clarification (Steel Man), Structural Analysis, Assumptions & Constraints, Edge Cases & Failure Modes, Trade-off Analysis, and Alternative Perspectives.
  • Practical applications during architecture reviews, API/interface design discussions, requirements validation, and risk assessment across product and engineering teams.

Quick Start

Run through the six-phase framework on a proposal to surface assumptions, edge cases, and trade-offs, then document concrete recommendations.

Frequently Asked Questions about critical-analysis

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

FAQPage Schema
How do I identify hidden assumptions and edge cases in an engineering proposal?

To identify hidden assumptions and edge cases in an engineering proposal, apply a structured critique framework that performs structural analysis and evaluates failure modes. This surfaces conceptual weaknesses and validates requirements before implementation begins.

What is the best way to critique system design and architecture reviews?

The best way to critique system design during architecture reviews is using a multi-phase analysis framework. This process guides you through trade-off analysis and alternative perspectives to expose logical gaps in technical arguments.

How does a steel man clarification technique work for technical arguments?

Steel man clarification works by reconstructing technical arguments into their strongest possible version before analysis. This ensures the structural analysis evaluates the most robust form of the engineering proposal rather than attacking weak points.

Can I use this critical analysis framework for API design and risk assessment?

Yes, you can use this critical analysis framework for API design discussions and risk assessment. It systematically evaluates constraints, trade-offs, and alternative perspectives across product and engineering teams to strengthen technical designs.

When do I need a formal critique framework for requirements validation?

You need a formal critique framework for requirements validation when technical arguments contain unexamined assumptions or potential failure modes. Applying adversarial analysis during the design phase prevents costly conceptual weaknesses from reaching implementation.

What are the limitations of applying adversarial analysis to system design?

A limitation of applying adversarial analysis to system design is that it focuses strictly on logical structures and technical arguments. It does not implement fixes itself, requiring teams to manually document and address the surfaced trade-offs and edge cases.