harness-creator

Builds machine-driven verification harnesses with Red/Green status detection for code and operations.

Updated May 20, 2026
One-click install
npx skills add https://github.com/TeXmeijin/agent-skills --skill harness-creator-texmeijin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-creator
Source: https://github.com/TeXmeijin/agent-skills/tree/main/.apm/skills/harness-creator
Command: npx skills add https://github.com/TeXmeijin/agent-skills --skill harness-creator-texmeijin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When asked to "build a harness," AI agents often produce static documents or checklists that lack machine-verifiable pass/fail judgment. This Skill enforces a strict definition of a verification harness and provides fixed procedures to build one that actually detects RED/GREEN states mechanically. ## Core Features & Use Cases - Two-scale classification: Distinguishes unit harnesses (hooks, CI steps, single checks requiring only Red/Green detection) from system harnesses (full REPF structure: Red/Green observation, Progress tracking, Executable artifacts, Flow documentation). - Anti-pattern guardrails: Rejects deliverables like Markdown runbooks, checklists, or dashboards that lack machine judgment, preventing false "harness" claims. - Reference pattern library: Ships a reusable pattern for pre/post state verification using already-authenticated CLIs (cloud, SaaS, hosting, DB) with read-only, idempotent check.sh scripts. - Use Case: Before a multi-resource cloud migration, generate a harness with check.sh, baseline snapshot, PROGRESS.md, and README so any future operator can resume work and verify GREEN completion with one command. ## Quick Start Ask the agent to build a verification harness for your migration or recurring check, and it will first confirm whether you need a unit or system harness before constructing the REPF structure.

Frequently Asked Questions about harness-creator

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

FAQPage Schema
How do I build a verification harness for a migration project?

Define the REPF structure first: a check.sh script for Red/Green observation, PROGRESS.md for tracking, executable resource files, and a README flow. Capture a baseline snapshot before starting, then verify GREEN completion by rerunning check.sh.

What is the difference between a unit harness and a system harness?

A unit harness is a small automated check inserted at a trigger point like a git hook or CI step, requiring only machine Red/Green judgment. A system harness covers multiple verification points with progress tracking, executable artifacts, and flow documentation (REPF).

Why is a Markdown checklist not considered a test harness?

A checklist lacks machine-executable Red/Green judgment, which is the minimum requirement for any harness. Documents can be outputs or accessories of a harness, but human visual inspection does not qualify as mechanical verification.

Can I use existing CLI tools for pre/post state verification?

Yes, if the CLIs are already authenticated with read-only permissions. The harness runs list/get/describe commands idempotently, fails fast on authentication errors, and outputs a table with GREEN/WARN/RED status plus a summary line.

When should I not use a system harness?

Avoid it when a single hook or CI step suffices, when state cannot be retrieved via CLI or API, or when results cannot be reduced to machine-judgeable statuses. Overbuilding REPF structure for a one-off check adds unnecessary overhead.