github/gh-aw

github-agentic-workflows

GitHub Agentic Workflows (`gh-aw`) is a GitHub CLI extension for writing Agentic Workflows in markdown and compiling them to GitHub Actions.

restricted-tool-triage

Operate safely and efficiently inside a gh-aw workflow with a restricted tools/bash allowlist, and correctly triage tool-denial events before they exhaust the session's denial budget.

sergo-examples

Optional Sergo examples for cache formats and reporting templates.

agentic-workflows

Route gh-aw workflow design/create/debug/upgrade requests to the right prompts.

go-linters

Add and validate custom Go analysis linters in gh-aw.

checkout-credential-review

Review code that performs git or gh operations against repository checkouts in gh-aw, checking that the right credentials are available at the right time and that sparseness, shallowness and credential-free factors are properly considered.

debugging-workflows

Debug gh-aw workflows using run logs, audits, and failure triage.

developer-internals

Internal gh-aw architecture: validation system design, safe output message patterns, schema validation, YAML compatibility notes, and MCP logs guardrail.

developer-security

Security best practices for gh-aw workflows and Go code: template injection prevention, shell script security, supply chain hardening, and static analysis integration.

error-recovery-patterns

Design gh-aw error handling, retry, recovery, and debugging flows.

http-mcp-headers

Implement secret-safe HTTP headers for MCP transport in gh-aw.

skillz-integration

Run and integrate Skillz MCP server with Docker for skill execution.

pr-finisher

Prepare an open pull request for merge from a GitHub Copilot cloud agent. Drives Reviews, local validation, and Mergeable to a ready state. Does not merge, and cannot trigger CI.

github-labels-query

List GitHub repository labels with per_page pagination and name filtering support.

developer

Core developer rules and coding conventions for gh-aw changes.

github-mcp-server

Reference for GitHub MCP server tools, methods, and usage patterns.

developer-code-organization

Code organization patterns, file structure guidelines, WASM build variants, and string processing conventions for gh-aw Go code.

developer-release

Release management, changeset workflow, firewall log parsing, breaking CLI change rules, and Go module summaries for gh-aw.

resolve-merge-conflicts

Merge a base ref and safely regenerate compiled workflow lock-file conflicts.

github-workflows-query

List GitHub Actions workflows with per_page pagination support.

copilot-review

Teach Copilot how to plan, address, and respond to pull request review feedback.

optimize-agentic-workflow

Analyze and reduce token consumption in agentic workflows — guardrail-specific entry points, measurement, and optimization techniques.

custom-agents

Define and validate GitHub custom agent files, prompts, and examples.

create-canvas

Author, validate, and debug canvas extensions that the agent can open in the GitHub Copilot app's side panel. Use when creating, reviewing, or troubleshooting a canvas extension — including its actions, inputs, rendered content, and the surrounding extension…

jqschema

Infer JSON structure and types with jq-based schema discovery.

github-pr-query

Query GitHub pull requests with jq filtering and reusable selectors.

prompt-token-efficiency

Rewrite prompts for minimal tokens, maximal clarity, and low ambiguity for LLM consumption.

workflow-step-summaries

Write clear GitHub Actions step summaries with progressive disclosure.

go-codemod

Implement and test Go codemods for the gh aw fix command.

playwright-cli

Automate browser interactions, test web pages and work with Playwright tests.

error-messages

Write consistent, actionable validation error messages in gh-aw.

reporting

Format reports with HTML details/summary blocks for readable output.

ssl-skill-normalizer

Normalize SKILL.md artifacts into Scheduling-Structural-Logical (SSL) JSON representations using a conservative multi-pass extraction pipeline.

pr-to-go-linter

Generate a new pkg/linters analyzer from a merged or open PR pattern.

awf-release-integrator

Upgrade gh-aw to latest gh-aw-firewall release and identify follow-up spec tasks.

console-rendering

Use Go struct tags to render styled terminal output in gh-aw.

documentation

Write concise Diataxis docs for gh-aw with Starlight markdown conventions.

error-pattern-safety

Apply safe error-pattern matching rules for agentic engines.

gh-agent-session

Use gh agent-session commands to inspect and manage agent sessions.

gh-agent-task

Use gh agent-task commands to create, run, and monitor agent tasks.