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.

custom-engine-implementation

Add and test declarative behavior-defined agentic engines in gh-aw, extending Go infrastructure only when necessary.

operational-value-designer

Design and verify a deterministic operational-value grader for any GitHub Agentic Workflow. Use when reasoning from workflow goals to measurable downstream outcomes, defining repository evidence, choosing outcome metrics, or creating an operational-value…

copilot-review

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

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.

resolve-merge-conflicts

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

developer-internals

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

error-pattern-safety

Apply safe error-pattern matching rules for agentic engines.

javascript-refactoring

Split large JavaScript files into maintainable modules safely.

messages

Add new safe-output message types and wire validation/rendering.

temporary-id-safe-output

Add temporary ID support to safe-output jobs end to end.

github-discussion-query

Query GitHub discussions with jq filtering and reusable selectors.

security-advisory-compat-enforcer

Review a GitHub security advisory and safely update .github/aw/compat.json with evidence-backed version enforcement.

awf-release-integrator

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

developer

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

open-pull-request

Publish validated gh-aw changes as a draft pull request from a cloud agent.

custom-agents

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

review-agentic-workflows

Review agentic workflow changes for correctness, security posture, and optimization opportunities with compile, validation, and audit evidence.

otel-queries

Analyze gh-aw OpenTelemetry traces from JSONL mirrors or OTLP backends.

skill-name

{what this skill teaches agents}

agent-collaboration

Standard collaboration patterns for all squad agents — worktree awareness, decisions, cross-agent communication

agent-conduct

Shared hard rules enforced across all squad agents

architectural-proposals

How to write comprehensive architectural proposals that drive alignment before code is written

ci-validation-gates

Defensive CI/CD patterns: semver validation, token checks, retry logic, draft detection — earned from v0.8.22

client-compatibility

Platform detection and adaptive spawning for CLI vs VS Code vs other surfaces

coordinator-init-mode

The complete two-phase Init Mode protocol the Squad coordinator runs when no team exists yet in the current repo. Phase 1 = propose the team (no files created, wait for user confirm). Phase 2 = create .squad/ scaffolding, casting state, .gitattributes for…

coordinator-response-mode

Selecting WHO handles work is the Routing table; selecting HOW they handle it (Direct, Lightweight, Standard, Full) is Response Mode. This skill contains the complete decision table, exemplar prompts for each mode, the Lightweight spawn template, and the…

coordinator-source-of-truth

The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-only, who may write each one, who may read each one, and the precedence rules when they conflict. Squad coordinator loads this on demand…

cross-machine-coordination

Enables squad agents on different machines to share work via git-based task queuing

cross-squad-communication

Protocol for sending queries, delegating tasks, and sharing context between independent Squad instances across different repositories

cross-squad

Coordinating work across multiple Squad instances — discovery, delegation, and disambiguation when the user says 'squad' (the product) vs casual English 'group of agents'.

distributed-mesh

How to coordinate with squads on different machines using git as transport

docs-standards

Microsoft Style Guide + Squad-specific documentation patterns

e2e-template-testing

End-to-end validation of coordinator and agent template changes

economy-mode

Shifts Layer 3 model selection to cost-optimized alternatives when economy mode is active.

error-recovery

Standard recovery patterns for all squad agents. When something fails, adapt — don't just report the failure.

external-comms

PAO workflow for scanning, drafting, and presenting community responses with human review gate

fact-checking

Review and validate claims using counter-hypothesis testing. Use when verifying technical content, checking references, validating API endpoints, or performing quality assurance on deliverables.

gh-auth-isolation

Safely manage multiple GitHub identities (EMU + personal) in agent workflows

git-workflow

Squad branching model: dev-first workflow with insiders preview channel