Agent skill · software engineering · borghei
focused-fix
This skill should be used when the user asks to "fix a bug with minimal changes", "analyze change scope for a bugfix", "find the minimal set of files to change", "do a focused bugfix", or "scope a minimal repair".
Why this skill is useful
Adds a specialized script for analyzing bug scope that the AI wouldn't reliably generate on its own.
What it needs
Requires python installed locally. About 4k tokens when loaded. Last updated 2026-07-21. 462 stars on the source repository.
What this skill does
Focused Fix Category: Engineering Domain: Debugging & Maintenance Overview The Focused Fix skill enforces a disciplined minimal-change approach to bug fixing. Instead of refactoring or improving code during a bugfix, it identifies the smallest possible change set that resolves the issue. This reduces risk, simplifies code review, and prevents scope creep. Use when The user asks to "fix a bug with minimal changes", "do a focused bugfix", or "scope a minimal repair" A bug report needs triage to identify the smallest set of files to touch A PR is at risk of scope creep (unrelated refactors, style changes, "nearby" fixes) A hotfix or release-blocker needs a low-risk, reviewable change set The user asks "what is the minimal change to fix X?" or "which files do I need to touch for this bug?" Clarify First Before scoping the fix, confirm these inputs. If any is unknown or vague, ASK — do not assume: [ ] Observable failure — the exact symptom, repro steps, and expected vs actual behavior (the bug description the analyzer matches against, and what the fix must resolve — not a guess at the cause) [ ] Codebase path & file types — which directory and extensions to search (sets --path/--extensions) [ ] Minimal vs structural — confirm this is a focused fix, not a refactor (determines whether out-of-scope "while I'm here" changes are rejected) Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact. Quick Start Tools Overview Tool Purpose Key Flags ------ --------- ----------- changescopeanalyzer.py Identify minimal files to change for a bugfix --bug, --path, --extensions, --format changescopeanalyzer.py Analyzes a bug description against a codebase to identify: Files most likely related to the bug (keyword matching, import tracing) Estimated change scope (number of files, lines) Risk assessment for the change Recommended fix approach (minimal vs. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills borghei/focused-fix