You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/agents/agentic-workflows.md
+18-32Lines changed: 18 additions & 32 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,6 @@
1
1
---
2
-
description: GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing
2
+
name: Agentic Workflows
3
+
description: GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing.
3
4
disable-model-invocation: true
4
5
---
5
6
@@ -24,9 +25,6 @@ This is a **dispatcher agent** that routes your request to the appropriate speci
24
25
-**Reducing token consumption / cost optimization**: Routes to `token-optimization` guide — consult this whenever the user asks how to reduce token usage, lower costs, speed up workflows, or measure the impact of prompt changes with experiments
25
26
-**Choosing workflow architectures and design patterns**: Routes to `patterns` guide — consult this whenever the user asks for strategy, architecture, operating models, or pattern selection for agentic workflows
26
27
27
-
> [!IMPORTANT]
28
-
> For architecture/pattern-selection requests, load `https://github.com/github/gh-aw/blob/v0.75.1/.github/aw/patterns.md` first.
29
-
30
28
Workflows may optionally include:
31
29
32
30
-**Project tracking / monitoring** (GitHub Projects updates, status reporting)
@@ -37,7 +35,7 @@ Workflows may optionally include:
37
35
- Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md`
@@ -108,7 +106,7 @@ When you interact with this agent, it will:
108
106
109
107
**Load when**: The workflow being created or updated produces reports — recurring status updates, audit summaries, analyses, or any structured output posted as a GitHub issue, discussion, or comment
@@ -132,7 +130,7 @@ When you interact with this agent, it will:
132
130
133
131
**Load when**: User needs to close or fix open Dependabot PRs that update dependencies in generated manifest files (`.github/workflows/package.json`, `.github/workflows/requirements.txt`, `.github/workflows/go.mod`)
@@ -144,31 +142,19 @@ When you interact with this agent, it will:
144
142
145
143
**Load when**: The workflow reads, analyzes, or reports test coverage — whether triggered by a PR, a schedule, or a slash command. Always consult this prompt before designing the coverage data strategy.
- "Create a workflow that comments coverage on PRs"
152
150
- "Analyze coverage trends over time"
153
151
- "Add a coverage gate that blocks PRs below a threshold"
154
152
155
-
### Render ASCII Charts in Markdown
156
-
157
-
**Load when**: The workflow needs in-markdown charts (sparklines, bars, table+trend views) that must align cleanly and render reliably across GitHub surfaces, including mobile.
- "Show a compact trend chart in an issue comment"
164
-
- "Render a dashboard table with sparkline trends"
165
-
- "Generate aligned ASCII bars for service metrics"
166
-
167
153
### CLI Commands Reference
168
154
169
155
**Load when**: The user asks how to run, compile, debug, or manage workflows from the command line; needs the MCP tool equivalent of a `gh aw` command; or is in a restricted environment (e.g., Copilot Cloud) without direct CLI access.
@@ -181,7 +167,7 @@ When you interact with this agent, it will:
181
167
182
168
**Load when**: The user asks how to reduce token usage, lower workflow costs, make a workflow faster or cheaper, or measure the impact of prompt or configuration changes.
@@ -210,7 +196,7 @@ When you interact with this agent, it will:
210
196
When a user interacts with you:
211
197
212
198
1.**Identify the task type** from the user's request
213
-
2.**Load the appropriate prompt** from the GitHub repository URLs listed above
199
+
2.**Load the appropriate prompt** from the repository paths listed above
214
200
3.**Follow the loaded prompt's instructions** exactly
215
201
4.**If uncertain**, ask clarifying questions to determine the right prompt
216
202
@@ -249,12 +235,12 @@ gh aw compile --validate
249
235
250
236
## Important Notes
251
237
252
-
- Always reference the instructions file at https://github.com/github/gh-aw/blob/v0.75.1/.github/aw/github-agentic-workflows.md for complete documentation
238
+
- Always reference the instructions file at `.github/aw/github-agentic-workflows.md` for complete documentation
253
239
- Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud
254
240
- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
255
241
-**Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF
256
242
- Follow security best practices: minimal permissions, explicit network access, no template injection
257
-
-**Network configuration**: Use ecosystem identifiers (`node`, `python`, `go`, etc.) or explicit FQDNs in `network.allowed`. Bare shorthands like `npm` or `pypi` are **not** valid. See https://github.com/github/gh-aw/blob/v0.75.1/.github/aw/network.md for the full list of valid ecosystem identifiers and domain patterns.
243
+
-**Network configuration**: Use ecosystem identifiers (`node`, `python`, `go`, etc.) or explicit FQDNs in `network.allowed`. Bare shorthands like `npm` or `pypi` are **not** valid. See `.github/aw/network.md` for the full list of valid ecosystem identifiers and domain patterns.
258
244
-**Single-file output**: When creating a workflow, produce exactly **one** workflow `.md` file. Do not create separate documentation files (architecture docs, runbooks, usage guides, etc.). If documentation is needed, add a brief `## Usage` section inside the workflow file itself.
259
245
-**Triggering runs**: Always use `gh aw run <workflow-name>` to trigger a workflow on demand — not `gh workflow run <file>.lock.yml`. `gh aw run` handles workflow resolution by short name, input parsing and validation, and correct run-tracking for agentic workflows. Use `--ref <branch>` to run on a specific branch.
260
-
-**CLI commands reference**: For a complete guide on all `gh aw` commands and their MCP tool equivalents (for restricted environments), see https://github.com/github/gh-aw/blob/v0.75.1/.github/aw/cli-commands.md
246
+
-**CLI commands reference**: For a complete guide on all `gh aw` commands and their MCP tool equivalents (for restricted environments), see `.github/aw/cli-commands.md`
description: Route gh-aw workflow create/debug/upgrade requests to the right prompts.
4
+
---
5
+
6
+
# Agentic Workflows Router
7
+
8
+
Use this skill when a user asks to create, update, debug, or upgrade GitHub Agentic Workflows in this repository.
9
+
10
+
This skill is a dispatcher: identify the task type, load the matching `.github/aw/*.md` file, and follow it directly. Keep responses concise and ask a clarifying question if the correct prompt is unclear.
11
+
12
+
Read only the files you need:
13
+
Load these files from `github/gh-aw` (they are not available locally).
14
+
15
+
After loading the matching workflow prompt, follow it directly:
16
+
17
+
- Create new workflows: `.github/aw/create-agentic-workflow.md`
- Map CLI commands to MCP usage: `.github/aw/cli-commands.md`
27
+
- Choose workflow architecture and patterns: `.github/aw/patterns.md`
28
+
- Optimize token usage and cost: `.github/aw/token-optimization.md`
29
+
30
+
When the task involves OTEL, OTLP, traces, observability backends, or telemetry-driven analysis, also read and follow `skills/otel-queries/SKILL.md` after loading the matching workflow prompt.
0 commit comments