Skill library / Codex / other agents
Bug Triage skill for Codex & others
Most debugging time goes on finding the cause, not fixing it. This skill gives Codex (and any Agent Skills tool) a disciplined loop: reproduce, isolate, fix minimally, and prove it with a test.
Customise this skill free →What it's good for
- Investigating stack traces from production logs
- Triaging GitHub issues
- Fixing flaky tests
How the skill works
- Restate expected vs actual behaviour
- Reproduce with the smallest possible input or test
- Trace the code path and form a hypothesis
- Apply the smallest fix that addresses the root cause
- Add a regression test that fails before and passes after
Built-in rules
- Don't refactor unrelated code during a fix
- Report if the bug can't be reproduced instead of guessing
- Explain the root cause in plain English
Example
You: “TypeError: cannot read 'id' of undefined in checkout.ts”
Result: A failing test, a root cause (race on cart load), a 3-line guard fix and a passing test.
SKILL.md template
Save as bug-triage/SKILL.md.
---
name: bug-triage
description: "Reproduces reported bugs, identifies the likely root cause, and proposes a minimal fix with a regression test. Use when the user reports a bug, pastes an error or stack trace, or asks why something is broken."
---
# Bug Triage
## Workflow
1. Restate expected vs actual behaviour
2. Reproduce with the smallest possible input or test
3. Trace the code path and form a hypothesis
4. Apply the smallest fix that addresses the root cause
5. Add a regression test that fails before and passes after
## Rules
- Don't refactor unrelated code during a fix
- Report if the bug can't be reproduced instead of guessing
- Explain the root cause in plain English
How to install in Codex & others
Put the folder in .agents/skills/ in your repo (read by Codex, Cursor, Gemini CLI, Copilot and others) or ~/.codex/skills/.
Pro tip
Install it in .agents/skills/ so Codex, Cursor, Gemini CLI and Copilot all share it.
Want it tailored to how you work?
Answer a few questions and get a customised version with examples, a Cursor rule and GPT/Gem instructions, emailed free.
Make my version →FAQ
How do I install the bug triage skill in Codex & others?
Put the folder in .agents/skills/ in your repo (read by Codex, Cursor, Gemini CLI, Copilot and others) or ~/.codex/skills/.
Is it free?
Yes. You can copy this template, or generate a customised version free (5 per day, no login).
Does it work on other platforms?
Yes. The SKILL.md follows the open Agent Skills standard, and every generated package also includes a Cursor rule and ChatGPT/Gemini instructions.