Generates a structured Bug Fix Brief (BFB) to document issue corrections. Includes root cause analysis, repro steps, fix options, and fix checklist.
SkillScore59Maintained
Automatic
◆Coding pack
Last verified 8/21/2026
What it changes
Passed 9 of 15 test cases with the skill, and 4 of 15 without it.
Without skill27%
With skill59%
Checks it passed that the model alone missed
The response includes an Observed field in section 1.
The response includes the command `mkdir -p docs/bfb`.
The response renders the fix items as markdown checkboxes.
and 9 more in the full report
9 fixed4 passed either way7 still failing2 broke
Pass-rate lift
+32 pp
Tokens
+7%
Agent turns
0%
Response time
-46%
Model gemini-3.6-flashMeasured 8/21/2026v113 of 22 cases passed with skill · 15 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 9 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 9
Prompt
When writing a BFB to disk for the first time in a fresh clone of our repository, what bash command should be run prior to saving the markdown file?
What was checked, without and with the skill
Checked
Without skill
With skill
The response includes the command `mkdir -p docs/bfb`.
Missed
Passed
case-22 · gemini-3.6-flash · 8/21/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md151 linessingle file
Bug Fix Brief (BFB)
Overview
This skill generates a Bug Fix Brief (BFB): a structured document in docs/bfb/ that uniformly captures every bug fix with root cause, repro steps, fix options, and checklist.
When to Use
User asks to create a BFB
User wants to document a bug fix in a structured way
After identifying the root cause of a bug and before implementing the fix