Skip to content

dvy1987/agent-loom / .agents/skills/fault-localize

fault-localize

Verified

Find the earliest decisive failure in an agent run trace and propose an evidence-backed targeted repair. Load when a run failed, results are wrong, or the user asks what went wrong in an agent session. Also triggers on "localize the fault", "first incorrect step", "debug this run", "trace attribution", "why did the agent fail", or after run-trace captures errors. Pairs with debug-and-fix for code defects and dynamic-routing for plan faults.

FileKindSize
SKILL.mdskill md3.7 KB
references/LOCALIZATION.mdmarkdown1.6 KB
references/examples.mdmarkdown685 B

references/examples.md

View on GitHub
# Fault Localize — Examples

## Ex.1 — Earliest tool error

**Trace:** S1 read file OK → S2 Shell npm test exit 1

**Output:**
```markdown
Suspected step: **S2** — earliest error
Hypothesis: test fails because DATABASE_URL unset [EXTRACTED: error in output_ref]
Layer: environment
Proposed repair: export DATABASE_URL=test or use .env.test
Replay: S2 only → pass
Outcome flip: true
```

## Ex.2 — Wrong localization

**Trace:** S1 wrong API URL in plan → S2 fetch 404 → S3 retry 404

**Output:**
```markdown
Suspected step: **S1** (not S3) — cognitive plan specified bad URL
Layer: plan
Handoff: dynamic-routing — revise S1 precondition, insert URL verify step
```
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall