orc-analyze

Analyzes requirements against code with quote-anchored evidence before planning begins.

6|1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/azure-id/orc --skill orc-analyze-azure-id
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: orc-analyze
Source: https://github.com/azure-id/orc/tree/main/templates/skills/orc-analyze
Command: npx skills add https://github.com/azure-id/orc --skill orc-analyze-azure-id

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Requirements documents and plain-language requests often conflict with what the code actually does, contain unstated assumptions, or bleed into scopes the user never asked for. This Skill turns a requirement (a document, PDF, or bare request) into a confirmed, code-grounded requirement set before any planning, so implementation never builds against stale claims or unverified assumptions. ## Core Features & Use Cases - Code-grounded reconciliation: Maps every requirement to real files with quote-anchored file:line evidence, classifying each as exists, missing, conflict, or buildable; unverifiable claims become explicit clarifying questions. - Scope bounding with anchored context: Bounds the deliverable to exactly the asked scope while pulling adjacent scopes in only as non-actionable, anchored "do not build" context. - Standard and Deep modes: Standard mode verifies a stated evidence floor; opt-in Deep mode adds orchestrator-dispatched parallel scouts, verify-every-claim coverage, and an alternatives-and-risks analysis. - Use Case: Given a security audit PDF, run "/orc-analyze security-audit.pdf — implement the AUTH findings only" to get a confirmed report.md and derived requirement-spec.md where stale findings are challenged and dropped before any build planning starts. ## Quick Start Ask the assistant to run /orc-analyze on your requirements document or plain-language feature request and confirm the detected mode and scope when prompted.

Frequently Asked Questions about orc-analyze

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

FAQPage Schema
How do I analyze a requirements document against my codebase before planning?▼

Run /orc-analyze with the document path or paste the requirement text. The skill detects the source mode (prose, audit, or bare requirement), reconciles each requirement against real code with file:line evidence, and produces a confirmed report plus a derived requirement spec.

What is the difference between standard and deep analysis mode?▼

Standard mode is single-pass and verifies a stated evidence floor covering file claims and status assertions. Deep mode requires explicit consent, runs two passes with parallel read-only scout agents, verifies every claim, and adds an alternatives-and-risks section.

Can orc-analyze handle a plain-language request with no document?▼

Yes. In requirement mode the user's request itself is the source of truth and is reconciled against the code, classifying each part as buildable, already existing, conflicting, or underspecified. Ungroundable parts become clarifying questions.

What happens when a requirement conflicts with the existing code?▼

Conflicts are raised as blocking challenges with two to three options and one flagged recommendation, asked one at a time. Every challenge and its resolution is recorded in the report before the spec is derived.

When should I use /orc-grill instead of /orc-analyze?▼

Use /orc-grill when the input is too thin to check against code, meaning it names no plausible subject or no expected outcome. The analyzer offers this as an option rather than blocking, and a sharpened grill result auto-feeds back into analysis.