ci-check

Parse GitHub Actions workflows to validate CI definitions locally.

35|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/sean-sunagaku/claude-code-plugin --skill ci-check-sean-sunagaku
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ci-check
Source: https://github.com/sean-sunagaku/claude-code-plugin/tree/main/ci-check/skills/ci-check
Command: npx skills add https://github.com/sean-sunagaku/claude-code-plugin --skill ci-check-sean-sunagaku

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Parses GitHub Actions workflows to enable local validation of CI definitions from .github/workflows/*.yml, reducing back-and-forth with remote runs.

Core Features & Use Cases

  • Extracts run steps from workflow definitions and reports which steps can run locally.
  • Skips deployment, secrets, and external actions to keep local runs safe and focused on core CI logic.
  • Supports full workflow execution, per-workflow execution, and dry-run verification to diagnose CI failures before merging.
  • Useful for teams maintaining multiple workflows and debugging flaky steps across projects.

Quick Start

Run scripts/run.sh --list to identify executable steps, then run scripts/run.sh to execute them locally.

Frequently Asked Questions about ci-check

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

FAQPage Schema
How do I run GitHub Actions workflows locally to validate CI definitions?

Run GitHub Actions workflows locally by parsing the YAML files in .github/workflows to extract run steps. This enables selective execution and dry-run verification of your CI logic directly on your machine.

Can I test specific steps from a GitHub Actions workflow without deploying?

Yes, you can test specific steps by listing executable run steps with a list command. The process skips deployment, secrets, and external actions to keep local execution safe and focused on core CI logic.

What is local CI dry-run verification for GitHub Actions?

Local CI dry-run verification is the process of parsing GitHub Actions workflows to extract and validate run steps locally. It reports pass or fail for each step, allowing you to diagnose CI failures before merging.

Does local workflow execution respect the working-directory specified in GitHub Actions YAML?

Yes, local workflow execution detects run steps and respects the working-directory parameter specified in your GitHub Actions YAML. This ensures that commands execute in the correct project context during local testing.

What are the limitations of running GitHub Actions CI locally?

When running GitHub Actions CI locally, the process intentionally skips deploy steps, secrets, and external actions. It focuses solely on validating core CI logic and run steps, so deployment sequences cannot be verified locally.

How do I debug flaky CI steps across multiple GitHub Actions workflows?

Debug flaky CI steps by parsing multiple GitHub Actions workflows to extract run steps for local execution. Running these steps locally reduces remote back-and-forth and helps isolate failing logic before merging.