{"manifest":{"name":"CI Fix Agent","version":"1.0.0","description":"Diagnoses failing CI/CD pipelines from build logs. Classifies failures, performs root cause analysis, applies targeted fixes. Inspired by Codex gh-fix-ci.","tags":["ci-cd","debugging","devops","workflow"],"standard":"agentskills.io","standard_version":"1.0","content_checksum":"3018d49aebd820be27760d5b2f3fa4c7adc4a1572d245c6daf7fb8254df9d90d","bundle_checksum":null,"metadata":{},"files":[]},"files":{"SKILL.md":"# CI Fix Agent\n\n> **Purpose:** Diagnose and fix failing CI/CD pipelines. Reads build logs, identifies root causes, and applies targeted fixes.\n\n---\n\n## Invocation\n\n```\n/fix-ci [--run-id ]\n```\n\nWithout a run ID, fetches the latest failed run for the current branch.\n\n---\n\n## Diagnosis Process\n\n### Step 1: Fetch CI Logs\n\n```bash\ngh run list --branch $(git branch --show-current) --status failure --limit 1\ngh run view --log-failed\n```\n\n### Step 2: Classify the Failure\n\n| Pattern | Category | Priority |\n|---------|----------|----------|\n| `npm ERR! peer dep` | Dependency conflict | High |\n| `ENOSPC` / `out of memory` | Resource limit | Medium |\n| `FAIL src/tests/` | Test failure | High |\n| `error TS` / `type error` | Type error | High |\n| `ESLint:` / `Lint error` | Lint violation | Low |\n| `ETIMEOUT` / `connect ECONNREFUSED` | Network/service | Medium |\n| `permission denied` | Permissions | Medium |\n| `Module not found` | Missing dependency | High |\n| `exit code 137` | OOM killed | High |\n\n### Step 3: Root Cause Analysis\n\nFor each failure category:\n\n**Test failures:**\n1. Read the failing test file\n2. Read the source file it tests\n3. Check recent changes to both: `git log --oneline -5 `\n4. Identify if the test or the source is wrong\n\n**Type errors:**\n1. Read the error location\n2. Check if types changed upstream\n3. Verify import paths are correct\n\n**Dependency issues:**\n1. Check `package-lock.json` for conflicts\n2. Compare with the last passing CI run\n3. Try `npm ci` vs `npm install`\n\n### Step 4: Apply Fix\n\n- Edit the minimum files needed\n- Run the same CI step locally to verify\n- Commit with: `fix(ci): `\n\n---\n\n## Common Fixes\n\n| Issue | Fix |\n|-------|-----|\n| Snapshot mismatch | `npx vitest run --update` if change is intentional |\n| Missing env var | Add to CI config secrets, not to code |\n| Lock file conflict | `npm ci` (clean install from lock) |\n| Flaky test (timing) | Add `vi.useFakeTimers()` or increase timeout |\n| OOM on build | Split the build step or increase runner memory |\n\n---\n\n## Rules\n\n- Never skip or delete failing tests — fix the root cause\n- Never add `--no-verify` or `continue-on-error` to hide failures\n- If a test is genuinely flaky, fix the flakiness don't skip it\n- Always verify the fix locally before pushing\n\n## Playground\n\n

Input: Failing CI step

Step: Build (npm run build)\nExit: 1\n\nError:\n./app/dashboard/page.tsx\nType error: Property 'slug' does\nnot exist on type 'Skill'.\n\n  45 |   return skill.slug

Output: Fix steps

Root cause\n`slug` was removed from the Skill\ntype in a recent schema update but\ndashboard/page.tsx still references it.\n\nFix\n1. Check lib/types/skill.ts for the\n   new field name (likely `handle`\n   or read from SKILLS_COLUMNS).\n2. Replace `skill.slug` with correct\n   field name.\n3. Search: grep -r \"skill\\.slug\" app/\n\nVerify\nnpm run build -- --no-lint\n→ must exit 0 before pushing

"}}