intent-critique

Critique Intent.md files for over-engineering and boundary issues.

15|5|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/ArcBlock/idd --skill intent-critique
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: intent-critique
Source: https://github.com/ArcBlock/idd/tree/main/skills/intent-critique
Command: npx skills add https://github.com/ArcBlock/idd --skill intent-critique

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured framework for critically evaluating Intent design quality and guiding interactive improvement discussions to refine decisions, reducing unnecessary complexity and aligning designs with user needs.

Core Features & Use Cases

  • Interactive critique workflow that identifies over-engineering, YAGNI, premature abstraction, and boundary issues.
  • Convergence checks, decision recording, and optional intent updates to net-reduce the design.
  • Works with /intent-critique to review a specific Intent.md or a directory of intents.

Quick Start

Run /intent-critique on the target INTENT.md to start an interactive critique session.

Frequently Asked Questions about intent-critique

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

FAQPage Schema
How do I critique an Intent specification for over-engineering and premature abstraction?

To critique an Intent specification for over-engineering, run an interactive workflow that identifies YAGNI violations and boundary issues, guiding a discussion to converge on a simpler design that preserves core constraints.

What is the best way to reduce unnecessary complexity in Intent design?

The best way to reduce unnecessary complexity in Intent design is applying structured convergence checks and recording decisions to net-reduce the specification while aligning the architecture with actual user needs.

Can I review a directory of Intent.md files for design quality issues at once?

Yes, you can target a specific Intent.md file or an entire directory of intents to initiate an interactive critique session that systematically identifies and refines design quality issues across the specifications.

How does an interactive critique workflow converge on a stronger Intent design?

An interactive critique workflow converges on a stronger Intent design by enforcing structured convergence checks, recording decisions, and applying optional updates that net-reduce complexity while maintaining the original core constraints.

When should I not use an interactive critique session for Intent refinement?

You should avoid an interactive critique session when the Intent specification is already minimal, lacks defined core constraints, or when automated refinement without guided discussion is sufficient for your architecture design needs.

Does intent-critique work without external dependencies to refine Intent architecture?

Yes, intent-critique operates without external dependencies, using an internal advanced reasoning framework to evaluate Intent design quality, identify risks, and guide interactive refinement discussions directly.