judge

Verify software implementations against dx declaration contracts via black-box testing.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/dewitt/dx --skill judge-dewitt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: judge
Source: https://github.com/dewitt/dx/tree/main/skills/judge
Command: npx skills add https://github.com/dewitt/dx --skill judge-dewitt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves the ambiguity between software specifications and their actual implementations by providing a rigorous, black-box verification process that identifies whether failures stem from implementation bugs or gaps in the specification itself.

Core Features & Use Cases

  • Contract Verification: Executes every defined contract in a dx declaration as a black-box test to ensure the implementation meets all requirements.
  • Classification Logic: Systematically categorizes failures as either implementation bugs or spec gaps, ensuring that the correct team is tasked with the fix.
  • Audit Trail Generation: Produces a version-controlled JUDGEMENT.md file that serves as an immutable record of conformance for specific commits.

Quick Start

Use the judge skill to verify the implementation against the system.md declaration and generate a formal judgement report.

Frequently Asked Questions about judge

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

FAQPage Schema
How do I verify software implementation conformance to specifications?

To verify implementation conformance to specifications, execute every defined contract in a declaration as a black-box test to ensure the software meets all requirements. This process systematically classifies failures into implementation bugs or specification gaps.

What is black-box contract testing for software compliance?

Black-box contract testing for software compliance validates target implementations against declared requirements without inspecting internal code. It executes defined contracts externally, categorizing any resulting failures as either implementation bugs or gaps within the specification.

Do I need the dx toolchain to run contract verification?

Yes, you need the dx toolchain to run contract verification. The verification process requires the dx toolchain specifically to enumerate declared contracts and execute them against the target implementation during the audit.

How do I generate an audit trail for software specification compliance?

To generate an audit trail for software specification compliance, run a verification process against your declarations to produce a version-controlled JUDGEMENT.md file. This file serves as an immutable record of conformance for specific commits.

Why does contract testing report specification gaps instead of just bugs?

Contract testing reports specification gaps alongside bugs because failures often stem from incomplete requirements rather than code errors. Systematically classifying failures into implementation bugs or spec gaps ensures the correct team receives the remediation task.

What is the best way to classify test failures during specification audits?

The best way to classify test failures during specification audits is systematic categorization into implementation bugs or specification gaps. This black-box testing approach ensures targeted remediation by directing fixes to the appropriate engineering or specification teams.