ci-debt-analyzer
CI debt analyzer: read CI configuration (GitHub Actions, GitLab CI, Jenkins, CircleCI), measure pipeline health, then LLM judges what is costing the team most. Read-only. Trigger: /ci-debt
SKILL.mdskills/operations/ci-debt-analyzer/SKILL.md
GitHub/ci-debt
CI pipelines silently rot. This skill measures pipeline health and identifies the biggest time waste.
What this is for
- Jobs that take 40 minutes because caching is missing
- Tests that always pass because they never run
- Matrix builds testing the same thing 8 times
- Read-only skill. No pipeline modification, no CI config changes.
PROTECTION RULE - never ~/.claude/
Read-only skill. Guard required if write mode added later.
What You Must Do When Invoked
During analysis, assign a confidence level to each finding: proven (confirmed by evidence), likely (strong signal, needs review), or suspected (weak signal).
If /ci-debt -help or /ci-debt -h (without further arguments)
is invoked: output the ## Usage section unchanged and stop.
Otherwise follow these steps in order, skipping none.
Step 1 - Help check
If invoked with -help or -h, output the ## Usage section unchanged and stop.
Step 2 - Clarify target
Clarify -ProjectDir. Get confirmation.
Step 3 - Scan
& "<SKILL_DIR>/scripts/ci-scan.ps1" -ProjectDir "<path>"
Step 4 - Analysis
Read the CI config and scan results:
- Identify the #1 time waste per pipeline
- Is the matrix appropriate for the project's support policy?
- Are tests actually running? Check for empty test commands, always-green steps
- Is caching missing? Are jobs sequential when they could be parallel?
Step 5 - Write report
File ci-debt-report.md in current working directory:
- Summary - estimated CI time, #1 bottleneck, potential time savings.
- Per-job analysis - job name, duration estimate, cache status, matrix efficiency, sequential blockers.
- Recommendations - specific config changes with estimated time savings.
- Open questions.
Step 6 - Summarize
State report path, highlight biggest potential time savings.
Usage
/ci-debt # interactive
/ci-debt <dir> # scan project
/ci-debt -help