Queue State Diff

Compare two queue or state snapshots and explain what changed between them. Use when Codex needs to analyze drift between JSON/JSONL snapshots, detect newly...

Security Scan

The skill's code and instructions align with its stated purpose: it compares two JSON snapshots and writes a simple diff report; it does not request credentials or perform network activity.

Purpose & Capability

The name/description (queue/state diff) match the provided script and SKILL.md. The script reads two JSON files, flattens them, and reports added/removed/changed keys — exactly what the skill claims to do.

Instruction Scope

SKILL.md instructs the agent to run the included Node script on two snapshot files and write an output file. That's within scope. Minor note: the example command uses path node skills/queue-state-diff/scripts/queue_state_diff.js while the included file is at scripts/queue_state_diff.js in the skill bundle; this assumes the skill will be placed under a skills/queue-state-diff directory at runtime. The script also writes to whatever --out path you supply, so avoid pointing --out at sensitive system paths.

Install Mechanism

This is an instruction-only skill with no install spec. No packages are downloaded or installed; runtime depends only on Node being available (the SKILL.md calls node).

Credentials

The skill requires no environment variables, no credentials, and accesses only the file paths provided as arguments. There are no hidden env var reads in the code.

Persistence & Privilege

always is false and the skill does not modify other skills or system-wide settings. It writes only the user-specified output file and creates its directory if needed.

Assessment

This skill appears to do what it says: compare two JSON snapshots and produce a markdown report. It does not contact the network or request credentials. Before running, ensure Node is available and: 1) provide the correct paths for --before and --after (they can be any files the agent can read), 2) choose a safe --out path so the script won't overwrite sensitive files, and 3) note the SKILL.md example assumes the skill is installed under skills/queue-state-diff — adjust the command if the script's actual path differs. If you need stricter controls, run the script manually on a trusted machine or inspect the two snapshot files first.

Use this skill to answer: what changed, what disappeared, and what got worse?

Workflow

1. Gather two comparable snapshots: before/after JSON, report JSON, or JSONL-derived exports.
2. Normalize them before reasoning; prefer deterministic diff over freehand comparison.
3. Run scripts/queue_state_diff.js for raw comparison.
4. Interpret the diff in terms of operational meaning: regressions, recoveries, or noise.

Script

node skills/queue-state-diff/scripts/queue_state_diff.js \
  --before out/report-before.json \
  --after out/report-after.json \
  --out out/queue-state-diff.md

Guardrails

• Compare like with like; do not diff unrelated report formats.
• Separate numeric drift from referential drift.
• Call out missing keys explicitly instead of treating them as zero.