ci-fix

Diagnoses GitHub Actions CI failures and applies minimal patches using the GitHub CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers quickly resolve GitHub Actions CI failures, minimizing downtime and ensuring code quality with minimal, reviewable changes.

Core Features & Use Cases

  • Automated Failure Diagnosis: Uses gh CLI to inspect failing CI runs, logs, and artifacts.
  • Root Cause Identification: Leverages a playbook to pinpoint common failure patterns.
  • Targeted Fixes: Applies minimal code or workflow patches.
  • Verification: Reruns jobs and verifies fixes using gh commands.
  • Use Case: A pull request fails its CI checks. This Skill can automatically investigate the failure, identify that a test is intermittently flaky, and rerun the specific job to confirm the fix.

Quick Start

Use the ci-fix skill to diagnose and resolve the latest CI failure in the current repository.

Frequently Asked Questions about ci-fix

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

FAQPage Schema
How do I fix GitHub Actions CI failures automatically?

To fix GitHub Actions CI failures automatically, you can use a tool that inspects failing runs, logs, and artifacts via the GitHub CLI. It identifies root causes using common patterns and applies minimal, reviewable patches to resolve the issues.

How do I troubleshoot a flaky test in my GitHub Actions CI run?

To troubleshoot a flaky test in GitHub Actions CI runs, inspect the failing job logs and artifacts using the GitHub CLI. Identifying the specific intermittent failure pattern allows you to apply targeted fixes and rerun the job to verify the success.

Can I diagnose GitHub Actions workflow errors using the gh CLI?

Yes, you can diagnose GitHub Actions workflow errors using the gh CLI. By inspecting the CI run logs and downloaded artifacts, the tool pinpoints common failure root causes and applies minimal patches directly to your workflows or code.

What is the best way to identify the root cause of a CI failure?

The best way to identify the root cause of a CI failure is to analyze the run logs and artifacts through the GitHub CLI. Leveraging a playbook of common failure patterns helps pinpoint the exact issue quickly before applying minimal code patches.

Do I need the GitHub CLI installed to automate CI failure resolution?

Yes, you need the GitHub CLI installed to automate CI failure resolution. The process relies entirely on gh commands to inspect runs, download artifacts, apply patches, and rerun jobs to verify that the applied fixes are successful.

Why does rerunning a failed GitHub Actions job not fix my intermittent CI failures?

Rerunning a failed GitHub Actions job does not fix intermittent CI failures if the underlying root cause remains unresolved. You must inspect the logs and artifacts, identify the flaky pattern, apply a minimal patch to the code, and then rerun to verify.