github-actions-review

Review GitHub Actions workflow YAML files for security and best practices.

1|Updated Dec 8, 2025
One-click install
npx skills add https://github.com/y-miyazaki/arc --skill github-actions-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-actions-review
Source: https://github.com/y-miyazaki/arc/tree/main/.github/skills/github-actions-review
Command: npx skills add https://github.com/y-miyazaki/arc --skill github-actions-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured, human-in-the-loop review of GitHub Actions Workflow configurations to ensure correctness, security, and adherence to best practices.

Core Features & Use Cases

  • Manual review focus: Assess design decisions, security patterns, and workflow architecture beyond automated linting.
  • Guidance for teams: Helps maintain consistent workflow quality across PRs and teams.
  • Review outcomes: Generates actionable feedback for workflow files and recommendations for safe patterns.

Quick Start

Use this skill to review a GitHub Actions workflow file in a pull request, applying the outlined guidelines to identify design and security issues.

Frequently Asked Questions about github-actions-review

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

FAQPage Schema
How do I review GitHub Actions workflows for security and best practices in a pull request?

Manual workflow review assesses design decisions, security patterns, and overall workflow architecture beyond automated linting. It evaluates explicit naming, restricted triggers, minimal permissions, secure secret handling, and deterministic action usage to generate actionable feedback.

How do I secure secrets and restrict permissions in GitHub Actions YAML files?

Securing GitHub Actions YAML files requires setting minimal top-level permissions and carefully handling secrets within step definitions. Restricting triggers and checking deterministic action usage further protects the workflow configuration from unauthorized access or injection.

What's the best way to check GitHub Actions workflow configurations for correctness?

The best way to check workflow configurations is a structured human-in-the-loop review focusing on design decisions and best practices. This approach validates explicit workflow naming, clear step definitions, and dependency checks to ensure correctness across project teams.

Does this GitHub Actions workflow review replace automated YAML linting?

No, this workflow review does not replace automated linting. It provides a manual, human-in-the-loop assessment of design decisions, security patterns, and overall workflow architecture, helping maintain consistent workflow quality across pull requests and teams.

Can I use this workflow review for any CI-CD pipeline using GitHub Actions?

Yes, you can use this review for any project using GitHub Actions. It applies to pull request reviews of workflow YAML files, focusing on security patterns, restricted triggers, minimal permissions, and deterministic action usage across different CI-CD setups.