plugin/skills/ci-debugging/SKILL.md
Diagnose and fix CI/CD pipeline failures: GitHub Actions errors, build failures, test timeouts, TLS/auth issues, platform-specific failures, dependency resolution problems, and deployment errors. Use when CI checks fail, builds break, tests timeout, or pipeline errors need systematic root-cause analysis and resolution.
npx skillsauth add kcenon/claude-config ci-debuggingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Determine which category the failure falls into:
| Category | Indicators | Priority | |----------|------------|----------| | Environment/Auth | TLS errors, token expired, permission denied | Check first | | Platform-Specific | Works on Linux fails on Windows, vice versa | Check second | | Missing Dependencies | Module not found, package missing | Check third | | Actual Code Bug | Test assertions, logic errors | Check last |
Check for sandboxed environment limitations:
# Test GitHub API connectivity
curl -s --connect-timeout 5 https://api.github.com/zen
# Check GitHub CLI auth status
gh auth status
# Verify GITHUB_TOKEN
echo "Token present: ${GITHUB_TOKEN:+yes}"
Common Issues:
gh auth loginLook for platform-specific patterns:
# Search for Unix-specific code
grep -rn "MSG_DONTWAIT\|/dev/null\|fork()" src/
# Check for Windows path issues
grep -rn '"/tmp\|"/var' src/
Fallback: Add conditional compilation or use cross-platform alternatives.
# Check for missing packages (Node.js)
npm ls 2>&1 | grep "MISSING" || echo "No missing npm packages"
# For Python
pip check 2>&1 || echo "No pip issues"
# For CMake/C++
cmake --build build/ 2>&1 | grep -i "error\|not found" || echo "Build OK"
If none of the above:
Priority order:
1. Use gh CLI (preferred)
2. Direct curl with GITHUB_TOKEN
3. Local git operations only
4. Manual intervention required
Priority order:
1. Check system certificates
2. Verify proxy settings
3. Use alternative connectivity check
4. Report as environment issue
| Issue | Command |
|-------|---------|
| Check CI logs | gh run view --log-failed |
| Re-run failed | gh run rerun --failed |
| View workflow | gh run view |
| Check auth | gh auth status |
| List failed runs | gh run list --status failure |
@./reference/common-failures.md
testing
Comprehensive security audit covering OWASP Top 10, input validation, authentication, authorization, secret management, dependency vulnerabilities, and injection attack prevention. Use when reviewing security posture, implementing auth flows, handling user input, auditing dependencies, conducting penetration test prep, or before production deployment.
development
Provides workflow guidelines for problem-solving, git commits, GitHub issues, PRs, build management, and testing. Use when planning tasks, creating issues, submitting PRs, managing builds, or writing tests.
development
Review pull requests with comprehensive analysis covering code quality, security vulnerabilities, performance implications, test coverage, documentation completeness, and architectural impact. Use when reviewing PRs, conducting code reviews, evaluating merge readiness, or assessing change impact across the codebase.
development
Performance optimization analysis: CPU/memory profiling, caching strategies, database query optimization, connection pooling, concurrency patterns, memory leak detection, and throughput improvement. Use when code is slow, memory usage is high, latency needs reduction, or conducting performance reviews before release.