Gavel bug
Writes standardized bug reports when an automated test confirms a real product defect. Use only after gavel-heal or gavel-analyze classifies APP BUG — not for flaky, env, or test-side failures.From its SKILL.md
npx -y skills add dsolisp/gavel --skill gavel-bugAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.9 KB, as published. Nobody here has run it
Gavel Bug
Standardized bug reporting from test failures.
When to Use
Invoke when ALL are true:
- An automated test has failed
- The failure is confirmed as a real bug (not flaky/env/test issue)
- The bug needs documentation for a developer to fix
Do NOT use for: test-side problems, missing docs, speculative issues.
Mandatory Template
[TICKET-ID]: <general title describing root cause, not the scenario>
=================================================================================
Issue Tracker: <URL or "Not yet filed">
Repo: <repository name>
Severity: Low | Medium | High | Critical
Found by: Automated test (<path-to-spec>)
Description
-----------
<2-4 sentences explaining the bug. State the contract violated.>
Steps to Reproduce
------------------
1. <precondition>
2. <action>
3. <observation>
Observed Result
---------------
<exact behavior, status codes, response bodies>
Expected Result
---------------
<what should happen per the contract>
Test Failure Location
---------------------
<relative spec path>:<line>
Backend Code Location
---------------------
**Primary: File [function_name](file:///path/to/file#L<start>-L<end>)**
<2-4 sentences explaining WHY this code is the culprit.>
Fix Recommendation
------------------
<what the dev should change. Don't prescribe exact code unless trivial.>
Workaround
----------
<what users/QA can do until fixed, or "None currently available".>
Quality Checks
- Title is general (describes class of bug, not specific test data)
- Backend Code Location points to source code, NOT the test
- Line ranges are real (verify by reading the file)
- One bug per report