How do I install the Github Actions Debug skill?

Run npx skillmds@latest add rivie13/github-actions-debug in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Github Actions Debug safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Github Actions Debug?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Github Actions Debug free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Github Actions Debug?

rivie13 (@rivie13) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Github Actions Debug by rivie13 — Agent Skill

Name: Github Actions Debug
Rating: 4.2 (5 reviews)
Author: rivie13

File contents

GitHub Actions Debug — Phoenix Agentic Website Frontend

Repo Context

Owner: rivie13
Repo: Phoenix-Agentic-Website-Frontend
Type: Public (Website Frontend)

Workflows in this repo

Workflow file	Purpose
`ci.yml`	Lint + Typecheck + Test + Build on push/PR to main

PR gate usage (required)

During PR work, treat failed GitHub Actions checks as a merge blocker:

Inspect failed runs for the PR branch.
Triage root cause from failing jobs.
Fix locally and re-validate (npm run lint; npm run typecheck; npm run test; npm run build).
Push and verify checks recover.

CI Pipeline Details

The ci.yml workflow runs:

Checkout code
Setup Node.js 20 with npm cache
Install dependencies: npm ci
Lint: npm run lint
Typecheck: npm run typecheck
Test: npm run test
Build: npm run build

Debugging Workflow: Step-by-step

Step 1: List recent workflow runs

mcp_github_github_actions_list(method="list_workflow_runs", owner="rivie13", repo="Phoenix-Agentic-Website-Frontend")

Step 2: List workflow jobs for the failed run

mcp_github_github_actions_list(method="list_workflow_jobs", owner="rivie13", repo="Phoenix-Agentic-Website-Frontend", resource_id="<RUN_ID>")

Step 3: Get job logs for the failed job

mcp_github_github_get_job_logs(owner="rivie13", repo="Phoenix-Agentic-Website-Frontend", job_id=<JOB_ID>)

Step 4: Analyze the failure

Common failure patterns:

Failure type	Typical cause	Fix
ESLint error	Style violations	Run `npm run lint` locally, fix violations
TypeScript error	Type mismatch, missing annotations	Run `npm run typecheck` locally
Test failure	Test assertion error	Run `npm run test` locally
Build failure	SSR-incompatible imports, missing env vars	Run `npm run build` locally
`npm ci` failure	Lock file out of sync	Run `npm install` and commit `package-lock.json`

Step 5: Fix locally and verify

Read the error from the job logs
Run locally:
- npm run lint — reproduce lint errors
- npm run typecheck — reproduce type errors
- npm run test — reproduce test failures
- npm run build — reproduce build failures
Make the fix
Run full check to confirm all pass

Step 6: Re-trigger the workflow (optional)

mcp_github_github_actions_run_trigger(owner="rivie13", repo="Phoenix-Agentic-Website-Frontend", workflow_id="ci.yml")

---name: github-actions-debugdescription: Debug failed GitHub Actions CI/CD workflow runs. Use when user asks to fix CI, debug a failed workflow, check why a build failed, investigate GitHub Actions errors, or troubleshoot pipeline failures.---# GitHub Actions Debug — Phoenix Agentic Website Frontend## Repo Context- **Owner**: `rivie13`- **Repo**: `Phoenix-Agentic-Website-Frontend`- **Type**: Public (Website Frontend)## Workflows in this repo| Workflow file | Purpose ||---------------|---------|| `ci.yml` | Lint + Typecheck + Test + Build on push/PR to main |## PR gate usage (required)During PR work, treat failed GitHub Actions checks as a merge blocker:1. Inspect failed runs for the PR branch.2. Triage root cause from failing jobs.3. Fix locally and re-validate (`npm run lint; npm run typecheck; npm run test; npm run build`).4. Push and verify checks recover.## CI Pipeline DetailsThe `ci.yml` workflow runs:1. **Checkout** code2. **Setup Node.js** 20 with npm cache3. **Install dependencies**: `npm ci`4. **Lint**: `npm run lint`5. **Typecheck**: `npm run typecheck`6. **Test**: `npm run test`7. **Build**: `npm run build`## Debugging Workflow: Step-by-step### Step 1: List recent workflow runs```mcp_github_github_actions_list(method="list_workflow_runs", owner="rivie13", repo="Phoenix-Agentic-Website-Frontend")```### Step 2: List workflow jobs for the failed run```mcp_github_github_actions_list(method="list_workflow_jobs", owner="rivie13", repo="Phoenix-Agentic-Website-Frontend", resource_id="<RUN_ID>")```### Step 3: Get job logs for the failed job```mcp_github_github_get_job_logs(owner="rivie13", repo="Phoenix-Agentic-Website-Frontend", job_id=<JOB_ID>)```### Step 4: Analyze the failureCommon failure patterns:| Failure type | Typical cause | Fix ||-------------|---------------|-----|| ESLint error | Style violations | Run `npm run lint` locally, fix violations || TypeScript error | Type mismatch, missing annotations | Run `npm run typecheck` locally || Test failure | Test assertion error | Run `npm run test` locally || Build failure | SSR-incompatible imports, missing env vars | Run `npm run build` locally || `npm ci` failure | Lock file out of sync | Run `npm install` and commit `package-lock.json` |### Step 5: Fix locally and verify1. Read the error from the job logs2. Run locally: - `npm run lint` — reproduce lint errors - `npm run typecheck` — reproduce type errors - `npm run test` — reproduce test failures - `npm run build` — reproduce build failures3. Make the fix4. Run full check to confirm all pass### Step 6: Re-trigger the workflow (optional)```mcp_github_github_actions_run_trigger(owner="rivie13", repo="Phoenix-Agentic-Website-Frontend", workflow_id="ci.yml")```

Frequently asked questions

Github Actions Debug