Fix ci
Skill KhaledSaeed18/dotclaude/.claude-plugin/plugins/engineering/skills/fix-ci
Reusable Claude Code extension registry. skills, subagents, slash commands, and hooks for engineering, git, testing, and security workflows. Distributed as a shadcn GitHub registry and as installable plugins.
npx -y skills add KhaledSaeed18/dotclaude --skill fix-ciAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Diagnose and fix a failing CI run by pulling the actual failure logs (gh run view --log-failed), reproducing the failure locally, fixing the root cause rather than the symptom, and verifying green before and after pushing. Use when a GitHub Actions run is red, a PR check is failing, or CI passes locally but fails remotely.
SKILL.md
3.1 KB, as published. Nobody here has run it
Fix the failure CI actually reported, not the one you assume it hit. The log line that failed the job is evidence; everything else is guessing. Pull it first, reproduce it locally second, and only then change code.
Step 1: Get the real failure
# What failed, and on which commit
gh run list --limit 10
gh run view <run-id> --log-failed 2>&1 | tail -80
Read the failed step's output completely. Identify: the failing step name, the exact error, and whether the failure is in your change or in the pipeline itself (setup step, cache, runner image, flaky network). If several jobs failed, find the first failure in dependency order; downstream jobs often fail as a consequence.
If the run belongs to a PR, also check which check is required and whether the failure is new to this branch:
gh pr checks <pr-number>
git log --oneline origin/main..HEAD
Step 2: Reproduce locally
Run the failing step's actual command from the workflow file, not your usual local equivalent:
# Read the workflow to get the exact command and environment
cat .github/workflows/<workflow>.yml
- Reproduces locally: it is a code problem. Debug it normally (the
systematic-debuggingskill applies) and fix the root cause. - Passes locally, fails in CI: the difference is environmental. Compare in this order: dependency install mode (
--frozen-lockfilevs a loose local install), Node/tool versions (CI pins one; check yours), OS differences (case-sensitive paths, line endings), missing env vars or secrets, and cache staleness. State which difference explains the failure before changing anything. - Not reproducible and clearly infrastructure (runner network blip, rate limit, timeout on a step that touches nothing you changed): rerun once with
gh run rerun <run-id> --failed. If it fails the same way twice, it is not flake; go back to evidence.
Step 3: Fix the cause, not the check
Make the smallest change that addresses the named root cause. Things that are not fixes:
- Deleting or skipping the failing test to make CI green.
- Loosening an assertion until it passes.
- Adding
continue-on-erroror removing the step. - Bumping a timeout without knowing why the step got slower.
Any of these may be proposed to the user with justification, but never applied silently as "the fix".
Step 4: Verify green, twice
- Locally: run the exact failing command again and confirm it passes, plus the project's full check suite so the fix didn't break a sibling.
- Remotely: push, then watch the run to completion rather than assuming:
gh run watch <new-run-id> --exit-status
Report the root cause, the fix, and the green run link. If the failure was flake, say so explicitly and note the rerun that confirmed it.