Skip to content

adamayoung/TMDb / .claude/skills/diagnose-ci-failure

diagnose-ci-failure

Verified

Diagnose a failing CI workflow run (lint, markdown lint, build, or unit tests) — identify which job failed, the cause, and a concrete fix

FileKindSize
SKILL.mdskill md6.2 KB
references/_index.mdmarkdown2.5 KB
references/build.mdmarkdown3.4 KB
references/lint.mdmarkdown4.9 KB
references/linux.mdmarkdown2.7 KB
references/markdown.mdmarkdown2.9 KB
references/unit-tests.mdmarkdown3.4 KB

references/_index.md

View on GitHub
# CI failure diagnosis — reference index

Each CI job has its own failure signature and reference file. Identify the
failing job (`mcp__github__pull_request_read` method `get_check_runs`, or
`mcp__github__get_job_logs` with `failed_only` — `gh pr checks` /
`gh run view <id> --log-failed` when headless without the MCP), then open the
matching file.

| Failing job (`name:` in ci.yml) | Reference | When to use |
|---|---|---|
| **Lint** | [lint.md](lint.md) | `swiftlint --strict .`, `swiftformat --lint .`, or one of the six `Scripts/*.py` gate steps failed |
| **Lint Markdown** | [markdown.md](markdown.md) | `markdownlint` failed on README, `CLAUDE.md`, a DocC `.md`, `.claude/**`, `knowledge/**` or `.github/*.md` |
| **Build and Test** (build step) | [build.md](build.md) | `swift build … -warnings-as-errors` failed (error or warning) |
| **Build and Test** (test step) | [unit-tests.md](unit-tests.md) | `swift test` failed (filter covers all four unit-test targets) |
| **Build (iOS / tvOS / watchOS / visionOS)** | [build.md](build.md) | the `xcodebuild` simulator matrix failed — platform availability/gating |
| **Build and Test (Linux)** | [linux.md](linux.md) | Fails in the `swift:6.1-jammy` container but passes on macOS |
| **Test (America/Los_Angeles or Pacific/Auckland)** | [unit-tests.md](unit-tests.md) | the TZ matrix failed — a date/calendar assertion depends on the runner's zone |

## By symptom

- `error: … is unavailable` / `cannot find … in scope`, **Linux only** → [linux.md](linux.md)
- `warning: … treated as error` → [build.md](build.md)
- `swiftc` `error:` on the macOS build → [build.md](build.md)
- `#expect`/`#require` failure, recorded `Suite/test` → [unit-tests.md](unit-tests.md)
- `keyNotFound` / `valueNotFound` / `typeMismatch` while decoding a fixture → [unit-tests.md](unit-tests.md)
- SwiftLint `(rule_id)` violation → [lint.md](lint.md)
- `superfluous_disable_command` on **unchanged** code → [lint.md](lint.md) (version drift)
- SwiftFormat `--lint` reports a file would change → [lint.md](lint.md)
- a `python3 Scripts/<name>.py` step failed (fixture / curation / prose / version / run-list) → [lint.md](lint.md)
- fails only in `Build (<platform>)`, macOS build green → [build.md](build.md) (availability gating)
- fails only in `Test (<timezone>)` → [unit-tests.md](unit-tests.md) (local-zone date dependency)
- markdownlint `MD0xx` → [markdown.md](markdown.md)

All paths share the [output format](../SKILL.md#output-format): **Summary / Cause / Fix**.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall