orc-challenge

Grades finished documents and code against a stated goal, then stops for external fixes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reviewing a finished artifact — a TSD, PRD, ADR, API contract, README, runbook, plan, or code module — is unreliable when the reviewer also wrote or fixed it, because a session that wrote the fix grades its own homework. This Skill separates the judge from the fixer: it grades the artifact against a goal you state, records findings, and stops, forcing fixes to happen in a fresh session. ## Core Features & Use Cases - Deterministic lint plus multi-lens council review: runs a zero-token lint, then dispatches parallel review lenses (cold reader, contrarian, outsider, executor, first-principles thinker, expansionist) whose findings a judge resolves with full conservation tracking. - Computed pass/fail with an auditable ledger: the CLI computes the verdict, enforces 100% finding coverage across iterations, detects tampering, and tracks stalled cycles instead of capping loops. - Fix briefs instead of in-session fixes: on failure it writes a paste-ready fix brief and stops; on pass it produces a final report with opportunities and premise challenges clearly marked as non-blocking. - Use Case: You finished a technical design document and want to know if a backend team can implement it without asking you questions. Run the challenge, answer the intake questions about goal and audience, receive graded findings across seven dimensions, fix in a new session, and resubmit until it passes. ## Quick Start Ask the assistant to run /orc-challenge on your finished design document and answer the seven intake questions about goal, audience, and review council.

Frequently Asked Questions about orc-challenge

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

FAQPage Schema
How do I review a technical design document for completeness?▼

Run /orc-challenge on the document and answer the intake questions defining the goal, audience, and definition of done. The skill lints the file, dispatches review lenses, and returns graded findings across dimensions like technical completeness and actionability.

How is this different from a standard code review or linting?▼

Code review reads a diff and a linter checks surface patterns; this evaluates a finished artifact against a stated goal, including whether a reader with no context can understand it. It contains a deterministic lint but adds grounded judgement across seven dimensions.

Can the skill fix the findings it reports?▼

No. It deliberately never fixes what it judged, because a session that wrote the fix would grade its own homework. It writes a fix brief to paste into a fresh session, then re-judges the revised artifact on your next run.

What artifact types does orc-challenge support?▼

It supports TSDs, PRDs, ADRs, API contracts, READMEs, runbooks, plans, and code modules. The artifact kind determines the proposed dimension set and suggested review council, which you confirm during intake.

What happens if a review never converges on a pass?▼

There is no hard loop cap. The status command reports a stalled flag once blocking findings stop decreasing across iterations, and offers three options: narrow the rubric, accept the gaps, or keep iterating.