Imported from zaha27/skills (
plugins/zaha/skills/bug/SKILL.md). Install upstream withnpx skills add zaha27/skills --skill bug. Copyright stays with the author.
Bug
Bugs live in docs/BUGS.md (root BUGS.md if that already exists; then keep its format). IDs are B-<nnn>, never reused. Log, don't fix: I'm probably in the middle of something else.
list
Show open bugs grouped by severity, one line each (B-007 [high] M2 · Login fails on Safari), then Suggested: /zaha:planning <top ID>. Stop.
No arguments
Ask what the bug is in one question. Then log it.
Log a bug
- Duplicates: grep
docs/BUGS.mdfor the key words. If an open bug looks like the same one, ask whether to add the new details to it instead. - ID: the highest existing number + 1, counting Open and Fixed. Start at
B-001. - Severity:
high: breaks a core flow, loses data, or is a security issue.med: wrong behavior with a workaround.low: cosmetic.
- Milestone: the roadmap milestone of the affected feature; else the one
[in progress]; else-. - Where (optional): at most one or two greps to point at the likely file. Don't read further and don't diagnose; that's
/zaha:planning's job. - Write the entry at the top of
## Open. If the bug blocks a roadmap task, append(B-007)to that task line. If it'shighand no task covers it, ask whether to add one.
If the description is too vague to reproduce, ask one question about it. Otherwise don't ask.
Format
# Bugs
## Open
### B-007 [high] M2 · Login fails on Safari
Found: 2026-09-28
Repro: log in on Safari 17 with valid credentials → bounced back to /login
Expected: lands on /dashboard
Where: src/auth/session.ts (cookie options), unconfirmed
## Fixed
- B-004 [med] M2 · Reset email sent twice · fixed 2026-09-27 in e4f5a6b
Open bugs get a heading and details; fixed ones collapse to one line (/zaha:recap moves them).
Reply
One line: Logged B-007 [high] M2 · Login fails on Safari, plus the blocked task if any, and Fix it: /zaha:planning B-007.
