diagnose-ci-failure

Diagnose GitHub Actions CI failures in SwiftUI projects.

1|Updated Dec 8, 2025
One-click install
npx skills add https://github.com/adamayoung/popcorn --skill diagnose-ci-failure
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose-ci-failure
Source: https://github.com/adamayoung/popcorn/tree/main/.claude/skills/diagnose-ci-failure
Command: npx skills add https://github.com/adamayoung/popcorn --skill diagnose-ci-failure

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a structured, triage-first approach to identifying and fixing failures in the Popcorn project's four blocking CI jobs, preventing time wasted on debugging transient issues.

Core Features & Use Cases

  • Job Routing: Automatically identifies whether a failure stems from Lint, Unit Tests, Snapshot Tests, or Release Builds.
  • Contextual Diagnosis: Provides specific playbooks for common Swift 6.2 concurrency errors, SwiftData store collisions, and snapshot regressions.
  • Use Case: When a PR fails the Build and Test job, use this skill to pinpoint the exact failing test suite or compile error and receive the correct local reproduction command.

Quick Start

Use the diagnose-ci-failure skill to analyze the failing CI job for the current pull request.

Frequently Asked Questions about diagnose-ci-failure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose GitHub Actions CI failures in a SwiftUI project?

Diagnosing GitHub Actions CI failures in a SwiftUI project requires a triage-first approach to identify whether the failure stems from linting violations, compilation errors, unit test regressions, or snapshot mismatches. Analyzing CI logs pinpoints the exact failing job for local reproduction.

How do I resolve Swift 6.2 concurrency errors blocking my CI workflow?

To resolve Swift 6.2 concurrency errors blocking your CI workflow, apply specific contextual playbooks designed for these failures. This process requires accessing CI logs to identify the exact compilation error and using local development tools to verify the build fixes.

What is the best way to fix SwiftData store collisions failing unit tests in CI?

The best way to fix SwiftData store collisions failing unit tests in CI is using a structured diagnosis playbook. It routes the failure to the Unit Tests job, identifies the collision from CI logs, and provides the correct local reproduction command to verify the fix.

Do I need local development tools to verify fixes for CI snapshot mismatches?

Yes, you need local development tools to verify fixes for CI snapshot mismatches. Resolving these failures requires reproducing the exact failing test suite locally to ensure the snapshot changes match expected outputs before pushing updates back to the pull request.

Why does my pull request fail the Release Build job in GitHub Actions?

Your pull request fails the Release Build job in GitHub Actions due to compilation errors or build target misconfigurations. Triage the CI logs to isolate the specific build failure and run the designated local build command to validate the resolution.

Can I use automated debugging to fix linting violations in GitHub Actions?

Yes, you can use automated debugging to fix linting violations in GitHub Actions. A triage-first approach automatically routes the failure to the Lint job, identifies the specific formatting or style violation, and allows you to verify the correction locally.