create-fix-pr
Investigates a root cause and files a minimal fix PR for a reported bug or observability finding.
Install
npx skills add https://github.com/launchdarkly/ai-tooling --skill create-fix-prSKILL.md
Create a fix PR
Overview
You are investigating a problem and filing a pull request that resolves it. This builds on the investigate skill — do the investigation properly first, don't jump to a fix without evidence.
Use the gh CLI for all GitHub operations (auth comes from your gh login) and standard Bash / Edit / Read / Grep for everything else.
Workflow
- Investigate. Use the
investigateskill to find the root cause. Cite the exact trace ID, log line, error group, and code location that pins the problem. - Confirm there isn't already a PR open. Before filing anything, search GitHub for an existing open PR addressing the same issue —
gh pr list --search "<keywords>" --state open. If one exists, direct the user to it — do not create a duplicate. - Judge whether a PR is the right tool. If the fix requires a config change, a flag flip, or a change outside the code you can access, describe the solution instead of filing a PR.
- Get the repo. Clone it if you don't already have it locally —
gh repo clone <owner>/<repo>. - Check for repo conventions. Read
agents.mdorCLAUDE.mdat the repo root — these describe repo-specific rules your fix needs to respect. - Make the change. Minimal diff. Don't refactor surrounding code, don't add features, don't fix unrelated bugs you happen to notice. One PR, one fix.
- Set git identity before committing — see
pr-conventions.md. - Commit, push, and file the PR. See
pr-conventions.mdfor branch naming and PR body rules.
What's a good fix
- Changes the smallest possible number of lines
- Preserves current production behavior unless the bug IS the current behavior
- Doesn't depend on assumptions you can't verify from the evidence
- Would pass a
code-reviewskill's check if one existed
What isn't
- Sweeping refactors unrelated to the reported problem
- Speculative null checks or error handling added "while you're in there"
- Changes to tests that hide the underlying bug
- Bumping dependency versions to fix a symptom
Restricted tools
If gh isn't installed or gh auth status shows no auth, surface the error to the user and stop — don't try alternative auth schemes.
Never include in a PR
- GitHub access tokens or any other secrets or credentials.
- Debugging logs or print statements you added during investigation.
Follow the repo's own commit and PR conventions for everything else.
Related skills
improve-codebase-architecturemattpocock1MScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.codebase-designmattpocock691KShared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.web-design-guidelinesvercel-labs676KReview UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".code-reviewmattpocock631KReview the changes since a fixed point (commit, branch, tag, or merge-base) along two axes: Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/spec asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to \"review since X\".
