github-pr-workflow-approval-gate

Approves GitHub Actions workflow runs stuck in action_required status blocking pull request merges.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/VilnaCRM-Org/claude-plugins --skill github-pr-workflow-approval-gate-vilnacrm-org
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-pr-workflow-approval-gate
Source: https://github.com/VilnaCRM-Org/claude-plugins/tree/main/plugins/react-frontend-sdlc/skills/github-pr-workflow-approval-gate
Command: npx skills add https://github.com/VilnaCRM-Org/claude-plugins --skill github-pr-workflow-approval-gate-vilnacrm-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? A pull request can stay blocked even when no check has failed, because the repository requires manual approval before workflows triggered by pull requests run. Those runs sit in action_required status, never execute, and the required checks they would report simply never appear — a silent blocker that looks like a green or pending checks page. ## Core Features & Use Cases - Detect withheld runs: Lists all workflow runs waiting in action_required status across the repository using the GitHub CLI, with pagination so busy repositories are not missed. - Bulk approval sweep: Approves every waiting run in one pass after the branch and diff have been reviewed, so required checks can finally report. - Post-approval verification: Re-reads check status only after runs have started, avoiding the trap of judging merge readiness while approved runs still report nothing. - Use Case: After pushing commits to a PR branch, the merge stays pending with no red checks. Run this Skill to find the unapproved workflow runs, approve them, and then re-check merge readiness once the required checks report. ## Quick Start Ask the assistant to find and approve any GitHub Actions workflow runs waiting for approval on this repository so the pull request checks can run.

Frequently Asked Questions about github-pr-workflow-approval-gate

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

FAQPage Schema
Why is my GitHub pull request not merging when no checks failed?▼

The repository likely requires manual approval before pull_request-triggered workflows run. Those runs sit in action_required status and never execute, so the required checks they would report never appear, silently blocking the merge.

How do I approve GitHub Actions workflow runs waiting for approval?▼

Use the GitHub CLI: list runs with gh api repos/OWNER/REPO/actions/runs?status=action_required, then POST to repos/OWNER/REPO/actions/runs/RUN_ID/approve for each run. Always review the branch and diff before approving.

Why do required checks never report after pushing to a PR branch?▼

Each push creates new workflow runs that queue in action_required if approval is required, so the checks they produce never start. You must sweep and approve runs again after every significant push.

Does this work for Next.js or component-library repositories?▼

Yes. The approval sweep is repository-agnostic and works for React SPA, Next.js app, and Storybook-first component-library shapes, since the approval requirement is a repository security setting, not a workflow property.

When should I not approve a waiting workflow run?▼

Do not approve before reviewing the branch and diff, since approval lets the repository's runners execute that code. Also, a run that started and failed is a real failure — fix its cause rather than re-approving.