spences10/ci-debug-workflow
plugins/devops-skills/skills/ci-debug-workflow/SKILL.md
Debug failing CI pipelines, containers, and reproduce bugs locally. Use when CI is red, containers won't start, or need to reproduce bugs.
$ install --global
skillsauthnpx skillsauth add spences10/claude-code-toolkit ci-debug-workflowInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 25, 2026, 7:21 AM10.8s4 files scanned
SKILL.md
- name:
- ci-debug-workflow
- description:
- Debug failing CI pipelines, containers, and reproduce bugs locally. Use when CI is red, containers won't start, or need to reproduce bugs.
CI Debug Workflow
Debug failing CI pipelines, containers, and reproduce bugs locally.
Trigger Patterns
- "fix failing CI"
- "debug this pipeline"
- "why is CI red"
- "container won't start"
- "reproduce this bug"
Workflow
1. Gather Context
Read CI logs first. Identify:
- Which step failed
- Error message/stack trace
- Environment differences from local
For bug reports, extract reproduction steps. See bug-thread-extraction.md.
2. Reproduce Locally
Never fix blind. Reproduce failure before changing code:
# Run same commands CI runs
npm ci && npm test
# Or match CI environment
docker build -t debug-image .
docker run --rm debug-image npm test
3. Identify Root Cause
Common CI failure patterns in ci-patterns.md:
- Dependency version mismatches
- Missing environment variables
- Timing/race conditions
- Platform differences (Linux vs macOS)
Container issues in docker-debug.md.
4. Apply Fix
Fix the actual issue, not symptoms:
- Pin dependency versions explicitly
- Add missing env vars to CI config
- Fix flaky tests with proper waits
- Use platform-agnostic paths
5. Verify
Push fix and confirm CI passes. Do not mark done until green.
git push && gh run watch
Anti-patterns
- Rerunning CI hoping it passes
- Fixing locally without reproducing CI environment
- Disabling failing tests
- Adding broad
|| trueto mask failures
References
- ci-patterns.md - Common CI failure patterns
- docker-debug.md - Container troubleshooting
- bug-thread-extraction.md - Parse bug reports
Related Skills
spences10/skill-creator
development
VerifiedTrustedCommunity
Design and create Claude Skills using progressive disclosure principles. Use when building new skills, planning skill architecture, or writing skill content.
29SKILL.mdUpdated Apr 25, 2026
spences10/research
testing
VerifiedTrustedCommunity
Verify sources before presenting findings. Use when asked to research links or documentation.
29SKILL.mdUpdated Apr 25, 2026
spences10/reflect
data-ai
VerifiedTrustedCommunity
Analyze session history for learnings and persist to skills. Solves "memory zero" - correct once, never again.
29SKILL.mdUpdated Apr 25, 2026
spences10/plugin-dev
tools
VerifiedTrustedCommunity
Validate, test, and distribute Claude Code plugins and marketplaces. Use when developing plugins, debugging validation errors, or preparing for distribution.
29SKILL.mdUpdated Apr 25, 2026