artifact-contract-auditor

Audit workspace outputs against pipeline artifact contracts and generate CONTRACT_REPORT.md.

497|38|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill artifact-contract-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: artifact-contract-auditor
Source: https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/artifact-contract-auditor
Command: npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill artifact-contract-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Ensures that a workspace's outputs align with the defined pipeline contract, guaranteeing completeness and self-containment for auditability and sharing.

Core Features & Use Cases

  • Contract Verification: Checks if all required outputs for 'DONE' units exist and if the pipeline's target artifacts are present.
  • Auditable Reports: Generates a CONTRACT_REPORT.md detailing any discrepancies.
  • Use Case: Before sharing a completed research workspace, run this skill to confirm all expected files are generated and no critical data is missing, providing a clear PASS/FAIL status.

Quick Start

Run the artifact contract auditor for the current workspace.

Frequently Asked Questions about artifact-contract-auditor

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

FAQPage Schema
How do I audit my workspace for missing pipeline artifacts?

To audit a workspace for missing pipeline artifacts, run the artifact contract auditor. It verifies completed unit outputs and target artifacts against the defined contract, generating a CONTRACT_REPORT.md detailing any missing files or drift.

What is pipeline artifact contract drift and how do I detect it?

Pipeline artifact contract drift occurs when generated workspace outputs deviate from defined pipeline requirements. Detect it by running an audit script that checks for expected target files and outputs a detailed CONTRACT_REPORT.md highlighting discrepancies.

How do I verify workspace completeness before sharing research outputs?

Verify workspace completeness before sharing by executing an analysis-only audit against your pipeline artifact contract. This validates that all required 'DONE' unit outputs exist, providing a clear PASS/FAIL status to ensure self-containment and auditability.

Can I check if all required output files exist in my workspace without modifying data?

Yes, you can check if required output files exist without modifying data by running an analysis-only audit operation. This verifies the presence of pipeline target artifacts and completed unit outputs, ensuring workspace integrity through a generated report.

What format does the workspace audit report use to document missing files?

The workspace audit report uses a Markdown format named CONTRACT_REPORT.md to document missing files. This auditable report details any discrepancies found during the artifact contract verification process, providing a clear overview of completeness.

Why does my workspace audit show missing files when pipeline units are marked DONE?

A workspace audit shows missing files when 'DONE' units lack their expected generated outputs as defined by the pipeline artifact contract. The auditor detects this contract drift and explicitly lists the absent files in the CONTRACT_REPORT.md.