bug-archaeology

Identify root causes of bugs via git bisect and document findings on issues.

10|Updated Sep 24, 2025
One-click install
npx skills add https://github.com/FriendlyInternet/nuxt-crouton --skill bug-archaeology
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-archaeology
Source: https://github.com/FriendlyInternet/nuxt-crouton/tree/main/.claude/skills/bug-archaeology
Command: npx skills add https://github.com/FriendlyInternet/nuxt-crouton --skill bug-archaeology

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of identifying the root cause of bugs by conducting git archaeology and recording findings before attempting to fix the issue.

Core Features & Use Cases

  • Bug Investigation: Researches the origin and introduction of bugs, differentiating between code regressions and environmental issues.
  • Git Archaeology: Utilizes git commands to find the first bad commit and trace the introduction of the bug.
  • Finding Documentation: Records findings on the tracking issue or PR, providing valuable information for future reference.

Quick Start

Use the bug-archaeology skill to investigate the cause of the 'stale local install' issue reported in the last release.

Frequently Asked Questions about bug-archaeology

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the root cause of a bug using git archaeology?

Git archaeology identifies the root cause of bugs by using git bisect to pinpoint the first bad commit, distinguishing code regressions from non-code issues. It systematically traces when and how the defect was introduced into the repository.

What is git bisect and when should I use it for bug investigation?

Git bisect is a debugging mechanism used during bug investigation to find the specific commit that introduced a regression. You should use it when you need to pinpoint the exact origin of a code defect by binary searching through your commit history.

How do I document bug investigation findings on an issue or pull request?

Documenting bug investigation findings involves recording the root cause analysis directly on the respective issue or PR. This ensures the git archaeology results, including the identified bad commit, are saved for future reference before any fixes are attempted.

Can I track down code regressions and separate them from environmental issues?

Yes, bug investigation differentiates between code regressions and environmental issues. By analyzing commit history and utilizing git commands, it determines whether the root cause stems from recent code changes or external non-code factors.

What is the best way to pinpoint the first bad commit in a repository?

The best way to pinpoint the first bad commit is by employing git bisect. This root cause analysis technique systematically narrows down the commit history to isolate the exact change that introduced the bug into the codebase.