cd /news/developer-tools/user-reported-bug-skill-to-help-the-… · home topics developer-tools article
[ARTICLE · art-26491] src=github.com ↗ pub= topic=developer-tools verified=true sentiment=· neutral

User reported bug skill to help the agent debug

A new OpenCode skill enforces a red-test-first workflow for bug reports, requiring the agent to reproduce the bug, write a failing test, log it, and only then propose a fix. The skill, available on GitHub, automatically triggers when a user reports a bug and ensures the test remains in the suite to prevent regressions.

read1 min publishedJun 13, 2026

OpenCode skill that enforces red-test-first when you report a bug. Instead of jumping to a fix, the agent reproduces the bug, writes a failing test that captures the symptom, logs it in a ledger, and only then proposes a fix.

Clone this repo directly into your OpenCode skills directory:

git clone https://github.com/Anhydrite/user-reported-bug-skills.git ~/.config/opencode/skills/user-reported-bug

Restart OpenCode. The skill triggers automatically when you report a bug (e.g. "j'ai un bug", "this is broken", "ça ne marche pas").

Reproduce first. The agent must see the bug fail before writing any test.Red test before fix. A failing test that asserts expected behavior is written and confirmed red.USER_FOUND tag. Every bug gets a comment block and a row in the ledger (docs/testing/user-found-bugs.md

).Fix only after the test exists. The fix is verified by the red test turning green.Guard test stays. The test remains in the suite to catch regressions.

Acknowledge & reproduce— agent reproduces the bug in a controlled way** Write the red test**— asserts expected behavior, fails because bug is unfixed** Confirm red**— test is run, must fail** Tag & ledger**—// USER_FOUND

comment + entry indocs/testing/user-found-bugs.md

Fix— minimal fix, red test turns green, no regressions** Update ledger**— status becomes FIXED with commit hash

── more in #developer-tools 4 stories · sorted by recency
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
Live at https://your-agent.zahid.host
Get free account → Pricing
from €0/mo · no card required
LIVE [news/user-reported-bug-sk…] indexed:0 read:1min 2026-06-13 ·