Skip to main content
skill CX Codex

investigate-bug — Claude Code skill for bug investigation

investigate-bug — a skill for Claude Code that gathers evidence and traces a bug to its cause before a fix is written. It starts on bug reports, incidents, customer complaints, or requests to reproduce an issue.

AGPL-3.0 ★ 1,120 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rerun-build/rerun --skill investigate-bug -a claude-code
Open on GitHub

What investigate-bug does

The skill reviews a bug report, checks whether the issue was already fixed, gathers logs and records, then tries to reproduce it and trace the faulty code path. Its report covers the symptoms, earlier fixes, reproduction steps, and a proposed minimal patch. The same findings are saved to .context/bugs/<slug>/report.md.

It searches Git history, pull requests, Notion cards, and data from PostHog, Dokploy, Trigger.dev, and Supabase. Local reproduction uses pnpm db:start and pnpm cloud env:local. Production and staging are read-only: the skill does not restart services or alter data. If the investigation points to a vulnerability, it switches to the security-fix skill.

What it helps with

  • check whether a bug already has a fix
  • collect logs and records related to an incident
  • reproduce an issue on the local stack
  • trace symptoms to a specific code line
  • write an investigation report with a minimal patch

Example prompts for the agent

  • Investigate why opening the project triggers an error and collect evidence.
  • Check this customer complaint, search for related bugs, and try to reproduce it.
  • Find the incident's root cause and save a report under .context/bugs/.

How to install investigate-bug

1Skills CLI (Vercel)

npx skills add rerun-build/rerun --skill investigate-bug -a claude-code

2Manually: put the files in place

~/.claude/skills/investigate-bug/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/investigate-bug/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about investigate-bug

How do I install investigate-bug in Claude Code?

Run npx skills add rerun-build/rerun --skill investigate-bug -a claude-code. The skill file is placed at ~/.claude/skills/investigate-bug/SKILL.md.

What does investigate-bug do?

It gathers evidence, looks for earlier fixes, attempts to reproduce the issue, and traces it to the responsible code. It then writes a report and suggests a minimal patch.

What does investigate-bug need to work?

Local reproduction uses pnpm db:start and pnpm cloud env:local. An investigation can also query Notion, PostHog, Dokploy, Trigger.dev, Supabase, and the engine API; production and staging access must remain read-only.

Similar skills

All skills for Testing and QA →

From the same set25

The whole set →
split-components The split-components Claude Code skill breaks up oversized component files into focused modules. It applies when a .tsx file grows crowded or before a new component is created. CX Codex +1 ★ 1,120repo stars sort-components The sort-components Claude Code skill sorts UI components into folders by feature. It activates when adding a component or reorganizing apps/ui/components/. CX Codex +1 ★ 1,120repo stars confirm-destructive-actions The confirm-destructive-actions Claude Code skill sets confirmation rules for risky UI actions. It activates when adding a destructive button or writing a confirmation dialog. CX Codex +1 ★ 1,120repo stars loading-skeletons A Claude Code skill for building loading skeletons that match each component’s layout. It applies when adding a loading state or replacing a spinner in a content area. CX Codex +1 ★ 1,120repo stars form-field-labels form-field-labels — a Claude Code skill routes form titles through the shared Field component. It activates when adding or redesigning a field in apps/ui. CX Codex +1 ★ 1,120repo stars create-dialog The create-dialog Claude Code skill sets patterns for creating and redesigning app dialogs. Short forms use a basic frame; lists that open detail views use a panel with stepped navigation. CX Codex +1 ★ 1,120repo stars shared-badge This Claude Code skill standardizes status and label pills with a shared Badge component. It activates when a badge is added to a list, table, or dialog. CX Codex +1 ★ 1,120repo stars update-docs The update-docs Claude Code skill checks Rerun’s documentation against code changes. It runs before work is marked done or a pull request is opened for changes to specified project areas, and on direct requests to update the docs. CX Codex +1 ★ 1,120repo stars

Project sponsors

Companies that keep this analytics open