SKILL

agent-run-forensics

Use when asked why an agent did something, what a past session or run changed, whether tests really passed, or to verify a session summary. Answers from the recorded transcript, not memory, with trace_finder.py, trace_timeline.py and claim_checker.py.

Target: Target not categorized. Automatically collected · unverified.

Excerpt from the author’s documentation

Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.

Read the original English text

Topics in the source

  • Agent Run Forensics
  • Workflow
  • Hard rules
  • Scripts
  • References and assets

Portability: 3 stdlib Python CLIs and one hook. Read-only, no network, no model calls. Secrets in transcripts are redacted in every output, with no switch to turn that off. Agents are confidently wrong about their own history. Asked "why did you change config.yaml?", an agent answers from what it remembers, and memory drops the parts that matter: the test run that failed, the file a sed -i one-liner rewrote, the edit made after the last green run. The harness recorded all of it. This skill makes the answer come from that recording. The rule: when a question is about something that already happened, read the trace before answering. Step 3 prints two lists and you keep them apart in the answer: | Label | Means | Example | |---|---|---| | recorded | The harness wrote it down when it happened | the command, its exit code, the agent's words in the same message | | inferred | Derived now by a named rule | prior-write, read-before-write, retry-after-failure, target-seen-in-output | Say "the trace shows" only for recorded edges. Name an inferred edge as inferred, with its rule. The agent's own stated reason is recorded as a claim, not as the cause. Step 4 turns each sentence of a summary i

This is an excerpt. Refer to the complete source and its current requirements.

Source repository
alirezarezvani/claude-skills
Source file
engineering/agent-run-forensics/skills/agent-run-forensics/SKILL.md
Fixed revision
8f082544116fc0d014188e521ca40304cdfc86b0
Read the complete original documentation ↗

Sources and evidence

This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.

Author: alirezarezvani/claude-skills · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-09T14:01:46.546Z.

Categories are inferred from names, descriptions and paths. They do not establish compatibility.

License and attribution

MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.

Original license ↗

Synchronization, copying and user-reported success do not mark a resource as runtime-tested.

Limitations and notes

  • Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.