review-agentic-workflows

Reviews agentic workflow changes for security regressions, validation results, and optimization opportunities.

5.1k|530|Updated Aug 12, 2025
One-click install
npx skills add https://github.com/github/gh-aw --skill review-agentic-workflows
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-agentic-workflows
Source: https://github.com/github/gh-aw/tree/main/.github/skills/review-agentic-workflows
Command: npx skills add https://github.com/github/gh-aw --skill review-agentic-workflows

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviewing changes to agentic workflows requires checking both the Markdown source and generated lock files for security regressions, compilation errors, and inefficient configurations, which is easy to get wrong manually.

Core Features & Use Cases

  • Security-first review: Detects permission expansions, relaxed security controls, unpinned actions, and injection risks in workflow diffs.
  • Strict compilation and scanning: Runs gh aw compile with actionlint, zizmor, poutine, runner-guard, yamllint, and shellcheck validators.
  • Run history auditing: Uses gh aw audit and logs to find high token usage, retries, and bottlenecks for optimization.
  • Use Case: When a pull request modifies .github/workflows/*.md files, use this Skill to produce a structured review with must-fix security regressions, scanner results, and optimization recommendations.

Quick Start

Review the agentic workflow changes in this pull request for security regressions and compile them with strict validation.

Frequently Asked Questions about review-agentic-workflows

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

FAQPage Schema
How do I review agentic workflow changes in a pull request?

Diff the .github/workflows directory against the base ref, then compile changed workflows with gh aw compile --strict and security scanners. Report findings as security regressions, validation results, and optimization opportunities with severity and remediation.

What security checks should agentic workflows pass?

Workflows should use least-privilege permissions, pin third-party actions by full commit SHA, avoid template injection of untrusted event data, and set explicit safe-outputs limits. Any permission expansion or relaxed security control is treated as suspicious until justified.

Which scanners does gh aw compile support for validation?

The strict compile command integrates actionlint, zizmor, poutine, runner-guard, yamllint, and shellcheck. Compilation errors or High/Critical security findings fail the review unless explicitly justified.

Can I audit past agentic workflow runs for optimization?

Yes, use gh aw audit with a run ID or URL and gh aw logs with a date range and workflow name. Look for high token usage, repeated retries, long-running steps, and firewall denials to recommend safe optimizations.

What if the gh aw CLI is not installed during review?

The skill checks for gh aw availability first and falls back to a local ./gh-aw binary if present. If neither exists and no install script is available, the review cannot proceed with compilation.