Fix
Diagnose a failing build or bug report and apply the minimal fix with tests.
by AgentVoltv1.0.0Published 1y ago1 install
Free to sign up · every skill included with AgentVolt Pro
Before & after
Same prompt, same agent — the only difference is the skill.
Prompt“CI is red on main. Fix it.”
Beforegeneric AI agent
Let me help you fix the failing build. I'll need to understand what's failing first. Common causes of a red build on main: - A merge that passed CI on the branch but conflicts semantically with another merge - A flaky test - A dependency that updated - An environment difference between local and CI I'd suggest checking the CI logs to see which step failed and what the error message says. If it's a test failure, look at what changed recently in that area. Can you share the CI output?
Afterwith Fix
Read the CI log. One failure, and it's real — not flaky.
FAILURE
api/billing/invoice.test.ts:88
Expected 2 invoice line items, received 3.
First red build: commit 4f2c9a1, merged 40 minutes ago.
CAUSE
4f2c9a1 added a proration line item to invoice generation. Correct
change. The test asserted an exact count and predates proration
existing, so it was always going to break the first time anyone added
a line type.
It passed on the branch because the branch forked before 7bd3e02,
which enabled proration by default. Neither commit is wrong; the
combination is. Standard semantic conflict — CI on each branch
couldn't have caught it.
MINIMAL FIX
The assertion is testing the wrong thing. It should assert the
subscription line is present and correct, not that exactly two lines
exist — the count is incidental and will break again next time.
- expect(invoice.lineItems).toHaveLength(2)
+ expect(invoice.lineItems).toContainEqual(
+ expect.objectContaining({ type: 'subscription', amount: 4900 })
+ )
TEST ADDED — covers the gap that let this through
A case asserting the proration line appears when a mid-cycle plan
change occurred. That behavior shipped in 4f2c9a1 with no test, which
is why the only signal was an unrelated assertion breaking.
SCOPE — deliberately not touched
The other 11 exact-length assertions in this file have the same
latent fragility. Not fixing them here: unrelated to the red build,
and a 12-assertion refactor on a hot main is how one red build
becomes two. Worth a follow-up.
VERIFY
Suite green locally, 3 consecutive runs. Ready to push.About this skill
name: fix description: Use when -
Fix
What you get
- Public GitHub repo (alirezarezvani/claude-skills)
- the fix skill folder with SKILL.md. Part of a 337-skill / 30-agent / 70-command install.
Customize your output
- Fork the repo and adapt the skill's instructions and references to your workflow.
Example output
Activates automatically when your request matches Fix; chains with the other skills, agents, and commands in the collection.
Best for
Creators, builders, and teams using Claude Code.
SKILL.md preview
SKILL.md
---
name: fix
description: Use when a failing build or bug report needs to be diagnosed and resolved with the minimal correct change plus test coverage.
version: 1.0.0
category: Development / Engineering
author: AgentVolt
license: proprietary
tags:
- development
- engineering
---
# Fix
Diagnoses a failing build or bug report and applies the minimal fix needed, backed by a test that would have caught the regression.
## When to use
… (sign up to view the full skill)Sign up to view, copy, and install the full skill
More development skills
View all Development skills →Generate
Scaffold code, tests, and boilerplate from a short spec.
Development
Performance Profiler
Systematic performance profiling for Node.js, Python, and Go applications.
Development
Threat Detection
Use when hunting for threats in an environment, analyzing IOCs, or detecting behavioral anomalies in telemetry.
Development
Agent Harness
Turns a domain folder of skills into a bounded agentic loop: compile a goal into a task plan, execute with the domain's tools, verify every task, retry within a budget.
Development