Skip to main content
skill CX Codex

investigating-ci-failures — Claude Code skill: CI failures

The investigating-ci-failures Claude Code skill traces an individual CI failure to its likely cause. It separates PR-specific problems from default-branch breaks and flaky tests.

no license 188 installs ★ 101 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add PostHog/ai-plugin --skill investigating-ci-failures -a claude-code
Open on GitHub

What investigating-ci-failures does

The skill examines a failed test or red CI run and classifies the failure as tied to a PR, the default branch, or a flaky test. For a default-branch incident, it traces the responsible commit, its author and PR, then checks whether a later commit fixed the problem.

It draws on engineering analytics tools, CI failure logs, and the engineering_analytics_ci_failures and engineering_analytics_ci_job_history views. The investigation compares branch patterns and job attempts; a CI rerun is not needed. Fingerprint analysis covers pytest only, so Jest, Playwright, and Cargo failures are examined through their raw log lines. Job history arrives through webhook sync and can lag.

What it helps with

  • tell whether a PR introduced a CI failure
  • trace a default-branch failure to a commit
  • identify the author and PR behind a breaking commit
  • distinguish a flaky test from a persistent failure
  • check whether a later commit fixed the failure

Example prompts for the agent

  • Investigate the CI failure in my PR and identify its cause.
  • Find the commit that made this test fail on the default branch.
  • Check whether this test fails intermittently or on every run.

How to install investigating-ci-failures

1Skills CLI (Vercel)

npx skills add PostHog/ai-plugin --skill investigating-ci-failures -a claude-code

2Manually: put the files in place

~/.claude/skills/investigating-ci-failures/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/investigating-ci-failures/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about investigating-ci-failures

How do I install investigating-ci-failures in Claude Code?

Run npx skills add PostHog/ai-plugin --skill investigating-ci-failures -a claude-code.

What does investigating-ci-failures do?

It investigates one CI failure and determines whether it belongs to a PR, the default branch, or a flaky test. For a default-branch failure, it traces the commit and checks for a later fix.

What does investigating-ci-failures need to work?

It uses the engineering-analytics-broken-tests tool, CI failure log tools, and the engineering_analytics_ci_failures and engineering_analytics_ci_job_history views.

Similar skills

All skills for Testing and QA →

From the same set82

The whole set →
signals-scout-skills-store signals-scout-skills-store audits shared PostHog agent skills for vague descriptions, oversized bodies, broken links, and leaked secrets. Produces reports with copy-ready fixes. CX Codex +1 193installs analyzing-expensive-users analyzing-expensive-users — a skill for Claude Code, Codex, Cursor and other agents that finds the top spenders in PostHog AI observability and explains what drives their costs. CX Codex +1 192installs turning-engineering-analytics-into-insights turning-engineering-analytics-into-insights — a skill for Claude Code and Codex: converts PR and CI metrics into saved PostHog insights, dashboards, and automated subscriptions. Triggers when visualizing engineering team performance. CX Codex +1 189installs investigating-logs The investigating-logs Claude Code skill investigates logs in a PostHog project, checks service health and traces error spikes. It runs for deploy checks, incident triage, change analysis, or a search around one trace or run. CX Codex +1 188installs review-hog-validation-criteria review-hog-validation-criteria serves as a final PR review gate, filtering candidate findings to keep real defects while discarding speculative noise. CX Codex +1 187installs review-hog-blind-spots-general The review-hog-blind-spots-general skill looks for concrete problems that earlier reviewers missed in a PR chunk. Use it as a final pass after other review perspectives have reported their findings. CX Codex +1 187installs review-hog-authoring review-hog-authoring — a guide skill for writing custom PostHog Review pieces: extra PR perspectives, your own blind-spot sweep, and the bars that decide what gets published or fixed. CX Codex +1 187installs review-hog-perspective-contracts-security review-hog-perspective-contracts-security is a Claude Code skill that checks code changes for security flaws and API compatibility breaks. It reports contract and security findings during PR review. CX Codex +1 187installs

Project sponsors

Companies that keep this analytics open