Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ulpi-io/skills --skill bugfix -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/bugfix/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/bugfix/

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.

Similar skills

All skills for Testing and QA →

From the same set49

The whole set →
code-simplify The code-simplify skill simplifies existing code without changing its behavior. Use it for a focused cleanup when the user explicitly asks for less complexity. CX Codex +1 186installs nextjs Guides coding agents through Next.js App Router tasks while respecting the project's installed framework release and internal architecture. CX Codex +1 182installs git-merge-expert git-merge-expert handles branch and PR merges, conflict resolution and rollbacks, checking readiness and writing a backup tag before anything moves. CX Codex +1 182installs map-project map-project inspects a single-app repository to build a concise CLAUDE.md router alongside detailed reference guides. CX Codex +1 176installs plan-founder-review plan-founder-review reads a plan and its JSON sidecar, checks every path and reuse claim against the real repository, then returns APPROVE, REVISE or REJECT before any agent starts work. CX Codex +1 170installs find-bugs find-bugs audits the current branch diff for real logic defects and security flaws. It verifies each issue against caller code and outputs evidence-backed findings. CX Codex +1 169installs plan-to-task-list-with-dag plan-to-task-list-with-dag turns a request into an executable task graph grounded in the repository, then saves it as Markdown and JSON. Use it when a project needs scoped, assigned work. CX Codex +1 168installs codemap This skill uses the codemap CLI to search code by intent and inspect repository dependencies. Use it to locate symbols or investigate how files relate. CX Codex +1 167installs

Project sponsors

Companies that keep this analytics open