bugfix — Claude Code skill: what it does, how to install
bugfix fixes confirmed bugs through a strict loop: reproduces failures with isolated tests, pinpoints root causes, and applies minimal diffs without weakening tests.
no license 176 installs ★ 5 updated 2026-08-31
npx skills add ulpi-io/skills --skill bugfix -a claude-codeWhat bugfix does
This workflow forces the assistant to follow a four-step cycle: reproduce, diagnose, apply a minimal fix, and verify regressions. Before editing code, it inspects manifest files like package.json, go.mod, or Cargo.toml to identify languages and frameworks, then pulls the matching reference rules.
The skill strictly blocks speculative edits. It requires a failing test harness before touching application files. When a bug cannot be reproduced reliably, the agent stops and explains the blocker instead of patching symptoms.
What it helps with
- write an isolated failing test before changing codebase files
- trace execution flows to diagnose broken root assumptions
- patch confirmed runtime defects with minimal code changes
- prevent regression failures while keeping test assertions strict
Example prompts for the agent
- /bugfix checkout crash when payload contains an empty shipping address
- Fix the runtime error in auth token renewal, write a test first
- /bugfix resolve finding #3 from the recent inspection
How to install bugfix
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill bugfix -a claude-code2Manually: put the files in place
~/.claude/skills/bugfix/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bugfix/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill bugfix -a codex2Manually: put the files in place
.agents/skills/bugfix/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill bugfix -a cursor2Manually: put the files in place
.cursor/skills/bugfix/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ulpi-io/skills bugfix2Manually: put the files in place
.github/skills/bugfix/SKILL.md1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill bugfix -a gemini-cli2Platform CLI
gemini skills install https://github.com/ulpi-io/skills --path bugfixManually: put the files in place
.devin/skills/bugfix/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill bugfix -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about bugfix
How to install bugfix in Claude Code?
Run npx skills add ulpi-io/skills --skill bugfix -a claude-code in your terminal. The configuration writes to ~/.claude/skills/bugfix/SKILL.md.
What does bugfix do?
It enforces a disciplined bug repair routine. The assistant maps out the project framework, writes a failing reproducer, diagnoses the underlying defect, and validates the patch.
Can bugfix work without an automated reproducer?
No, modifying code without a reproducer is blocked by default. The assistant must either build a failing test or explicitly report why reproduction failed.