git-bisect-debugging

Identify first bad commits using deterministic git bisect workflows.

7|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/KentoShimizu/sw-agent-skills --skill git-bisect-debugging-kentoshimizu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-bisect-debugging
Source: https://github.com/KentoShimizu/sw-agent-skills/tree/main/skills/git-bisect-debugging
Command: npx skills add https://github.com/KentoShimizu/sw-agent-skills --skill git-bisect-debugging-kentoshimizu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) components.

What problem does it solve?

This skill helps you identify the exact regression-causing commit by applying a deterministic git bisect workflow, enabling targeted fixes rather than chasing symptoms.

Core Features & Use Cases

  • Deterministic workflow: guided git bisect with structured endpoints to ensure repeatable identification of the first bad commit.
  • Audit-ready artifacts: produces session logs and a final culprit validation trail for peer review.
  • Use Case: when a reproducible regression exists but the introducing commit is unknown; you can pinpoint root cause and verify with systematic classifications.

Quick Start

Run the bisect workflow with a known-good commit and a known-bad commit to start the search.

Frequently Asked Questions about git-bisect-debugging

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

FAQPage Schema
How do I find the specific commit that introduced a regression in git?

Git bisect requires a known-good commit, a known-bad commit, and a deterministic classifier command to validate revisions. You must have a reproducible regression and reliable endpoints to successfully isolate the introducing commit.

What is the best way to automate git bisect to find a broken build?

Automating git bisect requires a deterministic classifier command that automatically tests intermediate commits between your known-good and known-bad endpoints, systematically narrowing down the search to the first bad commit.

Can I generate an audit log of my git bisect debugging session?

Yes, a structured git bisect workflow produces audit-ready artifacts including session logs and a final culprit validation trail, providing a documented history of the commit search for peer review.

Does git bisect work for non-deterministic or intermittent regressions?

Git bisect is designed for deterministic workflows and requires a reproducible regression. If the regression is intermittent or the classifier command is unreliable, the structured bisect process cannot accurately isolate the culprit commit.

How do I validate the root cause after a git bisect identifies a commit?

After git bisect identifies a commit, you validate the root cause using the final culprit validation trail generated during the session, verifying the systematic classifications and structured endpoints that isolated the regression.