
github / gh-aw
✓ Official★ 4,700A skill package that teaches your agent 19 capabilities — every one documented and browsable below, no GitHub required · by github.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Instructions for using the struct tag-based console rendering system in Go
1 file — installable on its own
Guide for debugging GitHub Agentic Workflows - analyzing logs, auditing runs, and troubleshooting issues
1 file — installable on its own
Developer Instructions for GitHub Agentic Workflows
1 file — installable on its own
Documentation Brief description for SEO and navigation
1 file — installable on its own
Error Message Style Guide for Validation Errors
2 files — installable on its own
Error Pattern Safety Guidelines for Agentic Engines
1 file — installable on its own
GitHub CLI Agent Session Extension
1 file — installable on its own
GitHub CLI Agent Task Extension
1 file — installable on its own
Tips and Tricks for Working with GitHub Copilot Agent PRs
1 file — installable on its own
Query GitHub discussions efficiently with jq argument support for filtering
3 files — installable on its own
Query GitHub issues efficiently with jq argument support for filtering
2 files — installable on its own
GitHub MCP Server Documentation
1 file — installable on its own
Query GitHub pull requests efficiently with jq argument support for filtering
2 files — installable on its own
Best practices for writing JavaScript code for GitHub Actions using github-script
1 file — installable on its own
Instructions for refactoring JavaScript code into separate files
1 file — installable on its own
JSON schema discovery utility that extracts structure and type information from JSON data
3 files — installable on its own
Instructions for adding new message types to the safe-output messages system
1 file — installable on its own
Guidelines for formatting reports using HTML details/summary tags
2 files — installable on its own
Plan for adding temporary ID support to safe output jobs
1 file — installable on its own
GitHub Agentic Workflows
Write agentic workflows in natural language markdown, and run them in GitHub Actions.
[!NOTE] Releases 0.68.4 through 0.71.3 are being retired due to a bug that impacts billing. If you are running one of these versions, please upgrade to the latest release as soon as possible.
Contents
- Quick Start
- Overview
- Guardrails
- Documentation
- FAQ
- Contributing
- Community Contributions
- Share Feedback
- Peli's Agent Factory
- Related Projects
Quick Start
Ready to get your first agentic workflow running? Follow our step-by-step Quick Start Guide to install the extension, add a sample workflow, and see it in action.
Overview
Learn about the concepts behind agentic workflows, explore available workflow types, and understand how AI can automate your repository tasks. See How It Works. Supports GitHub Copilot, Claude (Anthropic), Codex (OpenAI), and Gemini (Google) — pick whichever AI account you already have.
Guardrails
Guardrails, safety and security are foundational to GitHub Agentic Workflows. Workflows run with read-only permissions by default, with write operations only allowed through sanitized safe-outputs. The system implements multiple layers of protection including sandboxed execution, input sanitization, network isolation, supply chain security (SHA-pinned dependencies), tool allow-listing, and compile-time validation. Access can be gated to team members only, with human approval gates for critical operations, ensuring AI agents operate safely within controlled boundaries. See the Security Architecture for comprehensive details on threat modeling, implementation guidelines, and best practices.
Using agentic workflows in your repository requires careful attention to security considerations and careful human supervision, and even then things can still go wrong. Use it with caution, and at your own risk.
Documentation
For complete documentation, examples, and guides, see the Documentation. If you are an agent, see llms.txt source and llms-full.txt source.
If you are running a version between 0.68.4 and 0.71.3, upgrading is strongly recommended due to a bug that impacts billing.
Contributing
For development setup and contribution guidelines, see CONTRIBUTING.md.
Custom Go linters
To build and test repository custom linters:
go test ./pkg/linters/<linter-name>/...go build ./cmd/lintersmake golint-custom
make golint-custom builds cmd/linters and runs the custom analyzers against ./cmd/... and ./pkg/....
🌍 Community Contributions
<sup>Community members whose issues were resolved — updated automatically.</sup>
@ahmadabdalla (1) @AkshatRaj00 (1) @alcastaneda (1) @AlexDeMichieli (1) @alondahari (9) @anthonymastreanvae (8) @aoxiangtianyu-go (1) @apenab (1) @app/github-actions (10) @arthurfvives (7) @Artur- (1) @askpaisa (1) @astefan (1) @b2pacific (1) @bartul (1) @bbonafed (10) @benissimo (6) @benvillalobos (1) @bmerkle (2) @boydj (2) @Bra1nFartz (1) @bryanchen-d (13) @Calidus (4) @CatsMiaow (1) @chrizbo (4) @CiscoRob (1) @cknight (2) @clementbolin (1) @cogni-ai-ee (2) @consulthys (3) @corygehr (17) @Daidanny008 (1) @Dan-Albrecht (1) @danielmeppiel (3) @danquirk (1) @darwin-gonzales (1) @DeagleGross (1) @devantler (2) @deyaaeldeen (3) @dfrysinger (2) @dgolombek (1) @dholmes (2) @dkurepa (1) @drehelis (3) @dsibilio (1) @dsyme (1) @duncankmckinnon (1) @edburns (1) @edgeq (2) @ericstj (1) @Evangelink (1) @fbecar22 (1) @flatiron32 (1) @GandrotulaRajesh (1) @h-no (1) @h3y6e (2) @haavamoa (1) @heiskr (1) @hermanho (1) @hpsin (1) @IEvangelist (12) @ivancea (3) @jamesadevine (4) @JamesNK (4) @JanKrivanek (2) @jaroslawgajewski (10) @JasonYeMSFT (1) @jbaruch (1) @jcooklin (1) @jeffhandley (5) @jfomhover (1) @jitran (3) @joesturge (1) @johnpreed (1) @jonathanpeppers (3) @jsoref (2) @jsquire (1) @jtracey93 (1) @kaovilai (4) @karl-petter-sj (1) @katriendg (1) @kkruel8100 (1) @kthompson (1) @labudis (2) @ladamski (1) @lindeberg (1) @lpcox (5) @lupinthe14th (2) @mason-tim (5) @MatthewBunker (2) @MatthewLabasan-NBCU (1) @MattSkala (1) @MauroDruwel (4) @mdashrraf (1) @michen00 (2) @microsasa (3) @mnkiefer (1) @mrfelton (4) @mrjf (7) @nestele (1) @neta-vega (2) @NicolasRannou (1) @NikolajBjorner (2) @norrietaylor (8) @octatone (1) @PaulAylward2 (1) @petercort (1) @pethers (1) @pgaskin (1) @pholleran (1) @polmichel (2) @PureWeen (2) @rabo-unumed (3) @radiantspace (2) @reggie-k (1) @rhardouin (2) @romainh-betclic (1) @rspurgeon (1) @Rubyj (1) @ryckmansm (2) @samuelkahessay (2) @sbodapati-gfm (1) @seangibeault (1) @sg650 (11) @shiran-gutsy (1) @shubhamtanwar23 (3) @stefankrzyz (1) @strawgate (2) @susmahad (3) @szabta89 (2) @tadelesh (1) @theletterf (15) @tinytelly (1) @tore-unumed (10) @trask (4) @tsm-harmoney (5) @tvu4-wowcorp (1) @tylersmalley (1) @v1v (2) @verkyyi (2) @vishalagrawal-jisr (2) @wizardofosmium (1) @wtgodbe (2) @Yoyokrazy (2) @yskopets (45) @zarenner (5) @zkoppert (2)
Share Feedback
We welcome your feedback on GitHub Agentic Workflows!
Peli's Agent Factory
See the Peli's Agent Factory for a guided tour through many uses of agentic workflows.
Related Projects
GitHub Agentic Workflows is supported by companion projects that provide additional security and integration capabilities:
- Agent Workflow Firewall (AWF) - Network egress control for AI agents, providing domain-based access controls and activity logging for secure workflow execution
- MCP Gateway - Routes Model Context Protocol (MCP) server calls through a unified HTTP gateway for centralized access management
- gh-aw-actions - Shared library of custom GitHub Actions used by compiled workflows, providing functionality such as MCP server file management
Install the whole package (19 skills):
npx skills add https://github.com/github/gh-awOr install a single skill:
npx skills add https://github.com/github/gh-aw --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.