Entrar
wrsmith108

Check specific directory

by @wrsmith108 in Development
0
0
# Install this skill:
npx skills add wrsmith108/claude-skill-ci-doctor

Or install specific skill: npx add-skill https://github.com/wrsmith108/claude-skill-ci-doctor

# Description

Claude Code skill for diagnosing and fixing common CI/CD pipeline issues

# SKILL.md

CI Doctor Skill

Diagnoses and fixes common CI/CD pipeline issues automatically.

Trigger Phrases

  • "CI failing"
  • "workflow broken"
  • "pipeline error"
  • "GitHub Actions not working"
  • "build failed"
  • "CI not passing"
  • "fix CI"
  • "debug pipeline"

What This Skill Does

  1. Version Consistency Checks
  2. Compares Node.js versions across .nvmrc, package.json, Dockerfile, and CI workflows

  3. Flags any mismatches that could cause build failures

  4. CI Anti-Pattern Detection

  5. Command failures masked with || true
  6. npm ci without caching configured
  7. Errors suppressed without documentation

  8. Duplicate build steps that waste resources

  9. Workflow Validation

  10. Checks for common GitHub Actions configuration issues
  11. Validates job dependencies and artifact sharing

Usage

Automatic Invocation

Simply mention any trigger phrase in your request, and the skill will analyze your CI configuration.

Manual Invocation

# Run all CI health checks
npx tsx scripts/index.ts

# Output as JSON
npx tsx scripts/index.ts --json

# Check specific directory
npx tsx scripts/index.ts /path/to/project

Requirements

  • Node.js 18+
  • TypeScript (tsx for execution)
  • Project must have .github/workflows/ directory

# README.md

CI Doctor

A Claude Code skill for diagnosing and fixing common CI/CD pipeline issues automatically.

Installation

As a Claude Code Skill

# Clone to your Claude skills directory
git clone https://github.com/wrsmith108/claude-skill-ci-doctor.git ~/.claude/skills/ci-doctor

Standalone Usage

npx tsx ~/.claude/skills/ci-doctor/scripts/index.ts [project-dir] [options]

Trigger Phrases

This skill activates when you mention:
- "CI failing"
- "workflow broken"
- "pipeline error"
- "GitHub Actions not working"
- "build failed"
- "CI not passing"
- "fix CI"
- "debug pipeline"

Capabilities

1. Version Consistency Checks

  • Compares Node.js versions across .nvmrc, package.json, Dockerfile, and CI workflows
  • Flags any mismatches that could cause build failures

2. CI Anti-Pattern Detection

  • Command failures masked with || true
  • npm ci without caching configured
  • Errors suppressed without documentation
  • Duplicate build steps that waste resources

3. Workflow Validation

  • Checks for common GitHub Actions configuration issues
  • Validates job dependencies and artifact sharing

Usage

# Run all CI health checks
npx tsx scripts/index.ts

# Output as JSON
npx tsx scripts/index.ts --json

# Check specific directory
npx tsx scripts/index.ts /path/to/project

Output Example

## CI Health Check

### Critical Issues
| File | Expected | Actual | Issue |
|------|----------|--------|-------|
| .github/workflows/ci.yml | 20.x | 18.x | Node version mismatch with .nvmrc |

### Warnings
| File | Line | Pattern | Fix |
|------|------|---------|-----|
| ci.yml | 42 | npm ci without cache | Add actions/setup-node with cache |

### Passed Checks
- Node.js version consistent in package.json
- No duplicate build steps detected
- Artifacts properly shared between jobs

Exit Codes

  • 0 - No critical issues found
  • 1 - Critical issues detected

Requirements

  • Node.js 18+
  • TypeScript (tsx for execution)
  • Project must have .github/workflows/ directory

License

MIT

# Related Skills

facebook
feature-flags @facebook

Use when feature flag tests fail, flags need updating, understanding @gate pragmas, debugging...

★ 242,571
facebook
fix @facebook

Use when you have lint errors, formatting issues, or before committing code to ensure it passes CI.

★ 242,571
facebook
flags @facebook

Use when you need to check feature flag states, compare channels, or debug why a feature behaves...

★ 242,571

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.