ci-failure

Diagnoses GitHub Actions CI failures from logs and maps them to fixes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/sperezintexas/fintech-app --skill ci-failure
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ci-failure
Source: https://github.com/sperezintexas/fintech-app/tree/main/.cursor/skills/ci-failure
Command: npx skills add https://github.com/sperezintexas/fintech-app --skill ci-failure

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose GitHub Actions CI failures and suggest fixes. Use when the user reports CI failed, GitHub job failed, Actions failed, build failed on remote, upload artifact failed, or pastes a failure from the Actions tab.

Core Features & Use Cases

  • Load Context First: Read the repository CI configuration at .github/workflows/ci.yml (and .github/workflows/security.yml if the failure mentions security) and the pipeline summary at docs/ci.md to map the failure to a specific job and step, then apply repo-specific fixes.
  • Identify Job and Step: From the user’s message or pasted log, determine the Job name (e.g., Lint, Type Check, Test, Build, Docker Build, Notify Slack) and Step name (e.g., "Run ESLint", "Build application"); if only an error line is provided, infer the step from the message and the workflow.
  • Map to Fix: Provide actionable remediation guidance for common failure types (lint issues, type errors, test failures, build problems, artifact uploads, CI notifications) and reference the repo’s CI definitions to suggest concrete steps to resolve the failure.

Quick Start

Paste the failing CI log or describe the failure and I will diagnose the issue and propose fixes.

Frequently Asked Questions about ci-failure

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

FAQPage Schema
How do I diagnose a GitHub Actions CI failure from an error log?

To diagnose a GitHub Actions CI failure, paste the error log or describe the build failure. The tool reads your repository's workflow configuration to map the error to a specific job and step, then suggests actionable fixes.

Why does my GitHub Actions build fail on lint or type check steps?

GitHub Actions build failures on lint or type check steps occur when code violates repository rules. By analyzing the pasted CI log against your workflow definitions, the tool identifies the failing step and provides concrete remediation guidance.

Can I use this to fix failing artifact uploads in GitHub Actions?

Yes, you can fix failing artifact uploads in GitHub Actions. The tool maps upload artifact failures to the specific workflow step and provides actionable remediation guidance based on your repository's CI definitions.

What is the best way to troubleshoot a remote CI build failure?

The best way to troubleshoot a remote CI build failure is to provide the failing log or error message. The tool cross-references the failure with your CI configuration to pinpoint the exact job and step, guiding you to a resolution.

Does this tool work with custom workflow files like security.yml?

Yes, it works with custom workflow files like security.yml. When a failure mentions security, the tool reads the security workflow configuration alongside ci.yml to map the failure to the correct job and suggest fixes.

How do I map a CI failure to a specific job step when I only have an error line?

To map a CI failure to a specific job step from a single error line, the tool infers the failing step by analyzing the error message against your repository's workflow configuration and pipeline summary.