compare-state

Compare feedback-case directory state against prose descriptions of bugs or desired outcomes.

3|3|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/PioneerAIAcademy/cowork-genealogy --skill compare-state-pioneeraiacademy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: compare-state
Source: https://github.com/PioneerAIAcademy/cowork-genealogy/tree/main/.claude/skills/compare-state
Command: npx skills add https://github.com/PioneerAIAcademy/cowork-genealogy --skill compare-state-pioneeraiacademy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When triaging user feedback about agent behavior, you need to know whether a reported bug actually reproduces or whether a fix produces the intended result. This Skill automates that judgment by comparing the current state of a feedback-case directory (research.json, tree.gedcomx.json, results/) against the reporter's prose description of what went wrong or what should have happened. ## Core Features & Use Cases - Bug Reproduction Verification: Run with --against=what-went-wrong to confirm the reported bug reproduces against the agent_did field in _feedback/feedback.json. - Fix Validation: Run with --against=desired to verify a fix matches the agent_should_have description. - Structured Verdicts: Outputs a matches / partial / does-not-match verdict with a bullet list of concrete discrepancies mapped to the prose. - Fixture Validation: Aborts early with a specific message when feedback.json is missing, unparseable, or has a wrong schema_version, and handles legitimately empty fields without false aborts. - Use Case: After unzipping a feedback case with scripts/setup-feedback-case.sh and letting the agent run, invoke /compare-state --against=what-went-wrong to decide whether to iterate on a fix or escalate as not reproducible. ## Quick Start Run /compare-state --against=what-went-wrong inside an unzipped feedback-case directory to check whether the reported bug reproduces.

Frequently Asked Questions about compare-state

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

FAQPage Schema
How do I verify a reported bug reproduces in a feedback case?▼

Run /compare-state --against=what-went-wrong inside the unzipped case directory. The skill reads _feedback/feedback.json, inspects research.json, tree.gedcomx.json, and git-diffed files, then reports whether the state matches the agent_did description.

How do I check that a fix produces the desired outcome?▼

Invoke /compare-state --against=desired after applying the fix. It compares the current directory state against the agent_should_have field and returns a matches, partial, or does-not-match verdict with concrete findings.

What happens if feedback.json fields are empty?▼

Empty agent_did or agent_should_have fields are legitimate, not malformed fixtures. The skill stops with a plain result naming the empty field, quotes any submission Notes verbatim, and points to _feedback/session-log.jsonl when present.

Does compare-state work without a git baseline in the case directory?▼

Yes, it warns but continues. Without a .git/ directory, state-diff falls back to reading only the canonical files research.json and tree.gedcomx.json instead of diffing modified and untracked files.

Why does compare-state abort with a fixture error?▼

It aborts when _feedback/feedback.json is missing or unparseable, schema_version is not 1, or the target field is missing or not a string. The message names the specific field and points to the feedback-json-spec documentation.