tech-debt-ci-review · zaxbyhub — Claude Code skill: tech debt and CI audit
tech-debt-ci-review audits technical debt and shaky CI: test theater, flaky runs, green builds hiding a break. You get findings tied to files and lines, plus a fix order.
MIT ★ 539 updated 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill tech-debt-ci-review -a claude-codeWhat tech-debt-ci-review does
The skill digs into the debt that makes CI lie: tests passing without proving anything, flaky runs, green builds sitting on top of broken code. Its own body is short — an adapter for Codex that points at .claude/skills/tech-debt-ci-review/SKILL.md for the full audit structure.
It starts from what is really in the repo: the CI workflow definitions, the test scripts, the runs that broke last. Evidence gets gathered with shell commands and rg. Each finding arrives with a file and line, the impact, the proof behind it, and its place in the fix order. False green, false red, flaky CI and a stalled release all jump the queue.
The audit also pulls in $running-tests to pick validation commands and $engineering-conventions for repo invariants when a finding touches them. Both have to be there. Without $running-tests you are back to choosing what to run yourself. On Codex and OpenCode the same npx skills add works with -a codex or -a opencode.
What it helps with
- find tests that pass without checking anything
- catch flaky tests before a release stalls
- explain a CI failure that never reproduces locally
- get a fix order for structural debt with file and line refs
- tell a real breakage from a false red run
Example prompts for the agent
- Go through the workflow files and test scripts: where are we faking green, and what do we fix first?
- List the tech debt that keeps blocking green PRs, with file and line references and a remediation order
- Why does CI fail every other run? Check the recent failures and flaky tests
How to install tech-debt-ci-review
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill tech-debt-ci-review -a claude-code2Manually: put the files in place
~/.claude/skills/tech-debt-ci-review/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tech-debt-ci-review/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill tech-debt-ci-review -a codex2Manually: put the files in place
.agents/skills/tech-debt-ci-review/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill tech-debt-ci-review -a cursor2Manually: put the files in place
.cursor/skills/tech-debt-ci-review/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ZaxbyHub/opencode-swarm .agents/skills/tech-debt-ci-review2Manually: put the files in place
.github/skills/tech-debt-ci-review/SKILL.md1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill tech-debt-ci-review -a gemini-cli2Platform CLI
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .agents/skills/tech-debt-ci-reviewManually: put the files in place
.devin/skills/tech-debt-ci-review/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill tech-debt-ci-review -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tech-debt-ci-review
How do I install tech-debt-ci-review in Claude Code?
Run npx skills add ZaxbyHub/opencode-swarm --skill tech-debt-ci-review -a claude-code. The skill then sits at ~/.claude/skills/tech-debt-ci-review/SKILL.md.
What does tech-debt-ci-review do?
It looks for technical debt and CI instability: tests that prove nothing, flaky runs, brittle toolchain behaviour, and structure that keeps pull requests from going green. Findings come with file and line, impact, evidence and a remediation order.
What does the skill need to work?
$running-tests supplies the validation commands, and $engineering-conventions covers repo invariants when a finding touches them. The audit is built on the workflow files, test scripts and recent failures it reads.
Source text
SKILL.md · MIT
--- name: tech-debt-ci-review description: Codex adapter for deep technical-debt and CI-stability audits. Use when asked to find test theater, flaky tests, missing or mis-scoped tests, brittle CI/toolchain behavior, structural debt blocking green PRs, or a remediation order for opencode-swarm. metadata: audience: swarm-plugin --- # Tech Debt CI Review Read `.claude/skills/tech-debt-ci-review/SKILL.md` for the canonical audit structure. Codex-specific execution notes: - Start from actual CI/workflow files, test scripts, recent failures, and current repo state. - Use shell commands and `rg` to gather evidence; avoid broad `test_runner` scopes. - Prioritize findings that can cause false green, false red, flaky CI, or blocked release flow. - Produce findings with file/line references, impact, evidence, and a remediation order. Load `$running-tests` for validation command selection and `$engineering-conventions` when findings touch repo invariants.
© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm
Similar skills
All skills for Testing and QA →tech-debt-ci-review by other authors comes first.