From 14cbe47e7c1ca4de5370c58d7297d0f530ff4a4b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 31 Jul 2026 14:00:35 +0000 Subject: [PATCH 1/2] Configure repo agentic-workflows skill Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- SKILL.md | 22 ++++--- skills/agentic-workflows/SKILL.md | 100 ++++++++++++++++++++++++++++++ 2 files changed, 115 insertions(+), 7 deletions(-) create mode 100644 skills/agentic-workflows/SKILL.md diff --git a/SKILL.md b/SKILL.md index 6c4f09e6609..0d58c0aba0f 100644 --- a/SKILL.md +++ b/SKILL.md @@ -1,13 +1,20 @@ +--- +name: agentic-workflows +description: Repo entrypoint skill for gh-aw workflow authoring, routing, and troubleshooting. +--- + # gh-aw Prompt Surface -This repository builds **gh-aw** (GitHub Agentic Workflows), a GitHub CLI extension for writing workflows in markdown and compiling them to GitHub Actions. +This repository publishes the `agentic-workflows` skill. + +For gh-aw workflow design, creation, update, debug, or upgrade tasks, load and +follow `./skills/agentic-workflows/SKILL.md`. ## What this surface does -- Converts markdown workflow specs (`.md`) into compiled lock files (`.lock.yml`) -- Supports multiple AI engines (`copilot`, `claude`, `codex`, `custom`) -- Integrates tools, including GitHub MCP servers and safe-output tooling -- Provides CLI commands to compile, run, inspect, and audit workflows +- Exposes the installable `agentic-workflows` router skill for this repository +- Summarizes the gh-aw repository purpose for first-turn ambient context +- Points task-specific work to the deeper skill files only when needed ## Key concepts @@ -35,5 +42,6 @@ gh aw audit 24814681146 ## Where to learn more in this repo -- `/AGENTS.md` for development/agent workflow conventions -- `/skills/*/SKILL.md` for focused domain guidance (GitHub MCP, docs, errors, etc.) +- `/AGENTS.md` for development and agent workflow conventions +- `/skills/*/SKILL.md` for focused domain guidance +- `/.github/aw/*.md` for gh-aw workflow authoring and runtime reference material diff --git a/skills/agentic-workflows/SKILL.md b/skills/agentic-workflows/SKILL.md new file mode 100644 index 00000000000..6fb19019416 --- /dev/null +++ b/skills/agentic-workflows/SKILL.md @@ -0,0 +1,100 @@ +--- +name: agentic-workflows +description: Route gh-aw workflow design/create/debug/upgrade requests to the right prompts. +--- + +# Agentic Workflows Router + +Use this skill when a user asks to design, create, update, debug, or upgrade GitHub Agentic Workflows in this repository. + +This skill is a dispatcher: identify the task type, load the matching workflow prompt/skill file, and follow it directly. Keep responses concise and ask a clarifying question if the correct prompt is unclear. + +Repository overlay (optional): +- If `.github/aw/instructions.md` exists, load it with `@.github/aw/instructions.md` after loading the matched prompt/skill. +- Precedence: repository overlay instructions override upstream defaults when they conflict. + +Read only the files you need: +Load these files from `github/gh-aw` (they are not available locally). +- `.github/aw/action-container-substitutions.md` +- `.github/aw/agentic-chat.md` +- `.github/aw/agentic-workflows-mcp.md` +- `.github/aw/asciicharts.md` +- `.github/aw/campaign.md` +- `.github/aw/charts-trending.md` +- `.github/aw/charts.md` +- `.github/aw/cli-commands.md` +- `.github/aw/configure-agentic-engine.md` +- `.github/aw/context.md` +- `.github/aw/create-agentic-workflow-trigger-details.md` +- `.github/aw/create-agentic-workflow.md` +- `.github/aw/create-shared-agentic-workflow.md` +- `.github/aw/debug-agentic-workflow.md` +- `.github/aw/dependabot.md` +- `.github/aw/deployment-status.md` +- `.github/aw/designer.md` +- `.github/aw/evals.md` +- `.github/aw/experiments.md` +- `.github/aw/github-agentic-workflows.md` +- `.github/aw/github-mcp-server-pagination.md` +- `.github/aw/github-mcp-server.md` +- `.github/aw/instructions.md` +- `.github/aw/linter-workflows.md` +- `.github/aw/llms.md` +- `.github/aw/loop.md` +- `.github/aw/lsp.md` +- `.github/aw/mcp-clis.md` +- `.github/aw/memory-stateful-patterns.md` +- `.github/aw/memory.md` +- `.github/aw/messages.md` +- `.github/aw/multi-agent-research.md` +- `.github/aw/network.md` +- `.github/aw/optimize-agentic-workflow.md` +- `.github/aw/patterns.md` +- `.github/aw/pr-reviewer.md` +- `.github/aw/release-workflow.md` +- `.github/aw/report.md` +- `.github/aw/reuse.md` +- `.github/aw/safe-outputs-automation.md` +- `.github/aw/safe-outputs-content.md` +- `.github/aw/safe-outputs-management.md` +- `.github/aw/safe-outputs-runtime.md` +- `.github/aw/safe-outputs.md` +- `.github/aw/serena-tool.md` +- `.github/aw/shared-safe-jobs.md` +- `.github/aw/skills.md` +- `.github/aw/subagents.md` +- `.github/aw/syntax-agentic.md` +- `.github/aw/syntax-core.md` +- `.github/aw/syntax-engine.md` +- `.github/aw/syntax-tools-imports.md` +- `.github/aw/syntax.md` +- `.github/aw/test-coverage.md` +- `.github/aw/test-expression.md` +- `.github/aw/token-optimization-caching-budgets.md` +- `.github/aw/token-optimization.md` +- `.github/aw/triggers.md` +- `.github/aw/update-agentic-workflow.md` +- `.github/aw/upgrade-agentic-workflows.md` +- `.github/aw/visual-regression.md` +- `.github/aw/workflow-constraints.md` +- `.github/aw/workflow-editing.md` +- `.github/aw/workflow-patterns.md` + +After loading the matching workflow prompt or skill, follow it directly: +- Design workflows from scratch via interview: `.github/aw/designer.md` +- Create new workflows: `.github/aw/create-agentic-workflow.md` +- Configure or add declarative engines: `.github/aw/configure-agentic-engine.md` +- Update existing workflows: `.github/aw/update-agentic-workflow.md` +- Debug, audit, or investigate workflows: `.github/aw/debug-agentic-workflow.md` +- Upgrade workflows and fix deprecations: `.github/aw/upgrade-agentic-workflows.md` +- Create shared components or MCP wrappers: `.github/aw/create-shared-agentic-workflow.md` +- Create report-generating workflows: `.github/aw/report.md` +- Fix Dependabot manifest PRs: `.github/aw/dependabot.md` +- Analyze coverage workflows: `.github/aw/test-coverage.md` +- Render compact markdown charts: `.github/aw/asciicharts.md` +- Map CLI commands to MCP usage: `.github/aw/cli-commands.md` +- Choose workflow architecture and patterns: `.github/aw/patterns.md` +- Optimize token usage and cost: `.github/aw/token-optimization.md` +- Design long-running multi-agent research workflows: `.github/aw/multi-agent-research.md` + +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 or skill. From 774b63a84f4123987fdb61aaab27449b676a3858 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 31 Jul 2026 15:21:56 +0000 Subject: [PATCH 2/2] Fix repo skill entrypoint path Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- SKILL.md | 4 +- skills/agentic-workflows/SKILL.md | 100 ------------------------------ 2 files changed, 2 insertions(+), 102 deletions(-) delete mode 100644 skills/agentic-workflows/SKILL.md diff --git a/SKILL.md b/SKILL.md index 0d58c0aba0f..e02d2e89821 100644 --- a/SKILL.md +++ b/SKILL.md @@ -8,7 +8,7 @@ description: Repo entrypoint skill for gh-aw workflow authoring, routing, and tr This repository publishes the `agentic-workflows` skill. For gh-aw workflow design, creation, update, debug, or upgrade tasks, load and -follow `./skills/agentic-workflows/SKILL.md`. +follow `./.github/skills/agentic-workflows/SKILL.md`. ## What this surface does @@ -43,5 +43,5 @@ gh aw audit 24814681146 ## Where to learn more in this repo - `/AGENTS.md` for development and agent workflow conventions -- `/skills/*/SKILL.md` for focused domain guidance +- `/.github/skills/*/SKILL.md` for focused domain guidance - `/.github/aw/*.md` for gh-aw workflow authoring and runtime reference material diff --git a/skills/agentic-workflows/SKILL.md b/skills/agentic-workflows/SKILL.md deleted file mode 100644 index 6fb19019416..00000000000 --- a/skills/agentic-workflows/SKILL.md +++ /dev/null @@ -1,100 +0,0 @@ ---- -name: agentic-workflows -description: Route gh-aw workflow design/create/debug/upgrade requests to the right prompts. ---- - -# Agentic Workflows Router - -Use this skill when a user asks to design, create, update, debug, or upgrade GitHub Agentic Workflows in this repository. - -This skill is a dispatcher: identify the task type, load the matching workflow prompt/skill file, and follow it directly. Keep responses concise and ask a clarifying question if the correct prompt is unclear. - -Repository overlay (optional): -- If `.github/aw/instructions.md` exists, load it with `@.github/aw/instructions.md` after loading the matched prompt/skill. -- Precedence: repository overlay instructions override upstream defaults when they conflict. - -Read only the files you need: -Load these files from `github/gh-aw` (they are not available locally). -- `.github/aw/action-container-substitutions.md` -- `.github/aw/agentic-chat.md` -- `.github/aw/agentic-workflows-mcp.md` -- `.github/aw/asciicharts.md` -- `.github/aw/campaign.md` -- `.github/aw/charts-trending.md` -- `.github/aw/charts.md` -- `.github/aw/cli-commands.md` -- `.github/aw/configure-agentic-engine.md` -- `.github/aw/context.md` -- `.github/aw/create-agentic-workflow-trigger-details.md` -- `.github/aw/create-agentic-workflow.md` -- `.github/aw/create-shared-agentic-workflow.md` -- `.github/aw/debug-agentic-workflow.md` -- `.github/aw/dependabot.md` -- `.github/aw/deployment-status.md` -- `.github/aw/designer.md` -- `.github/aw/evals.md` -- `.github/aw/experiments.md` -- `.github/aw/github-agentic-workflows.md` -- `.github/aw/github-mcp-server-pagination.md` -- `.github/aw/github-mcp-server.md` -- `.github/aw/instructions.md` -- `.github/aw/linter-workflows.md` -- `.github/aw/llms.md` -- `.github/aw/loop.md` -- `.github/aw/lsp.md` -- `.github/aw/mcp-clis.md` -- `.github/aw/memory-stateful-patterns.md` -- `.github/aw/memory.md` -- `.github/aw/messages.md` -- `.github/aw/multi-agent-research.md` -- `.github/aw/network.md` -- `.github/aw/optimize-agentic-workflow.md` -- `.github/aw/patterns.md` -- `.github/aw/pr-reviewer.md` -- `.github/aw/release-workflow.md` -- `.github/aw/report.md` -- `.github/aw/reuse.md` -- `.github/aw/safe-outputs-automation.md` -- `.github/aw/safe-outputs-content.md` -- `.github/aw/safe-outputs-management.md` -- `.github/aw/safe-outputs-runtime.md` -- `.github/aw/safe-outputs.md` -- `.github/aw/serena-tool.md` -- `.github/aw/shared-safe-jobs.md` -- `.github/aw/skills.md` -- `.github/aw/subagents.md` -- `.github/aw/syntax-agentic.md` -- `.github/aw/syntax-core.md` -- `.github/aw/syntax-engine.md` -- `.github/aw/syntax-tools-imports.md` -- `.github/aw/syntax.md` -- `.github/aw/test-coverage.md` -- `.github/aw/test-expression.md` -- `.github/aw/token-optimization-caching-budgets.md` -- `.github/aw/token-optimization.md` -- `.github/aw/triggers.md` -- `.github/aw/update-agentic-workflow.md` -- `.github/aw/upgrade-agentic-workflows.md` -- `.github/aw/visual-regression.md` -- `.github/aw/workflow-constraints.md` -- `.github/aw/workflow-editing.md` -- `.github/aw/workflow-patterns.md` - -After loading the matching workflow prompt or skill, follow it directly: -- Design workflows from scratch via interview: `.github/aw/designer.md` -- Create new workflows: `.github/aw/create-agentic-workflow.md` -- Configure or add declarative engines: `.github/aw/configure-agentic-engine.md` -- Update existing workflows: `.github/aw/update-agentic-workflow.md` -- Debug, audit, or investigate workflows: `.github/aw/debug-agentic-workflow.md` -- Upgrade workflows and fix deprecations: `.github/aw/upgrade-agentic-workflows.md` -- Create shared components or MCP wrappers: `.github/aw/create-shared-agentic-workflow.md` -- Create report-generating workflows: `.github/aw/report.md` -- Fix Dependabot manifest PRs: `.github/aw/dependabot.md` -- Analyze coverage workflows: `.github/aw/test-coverage.md` -- Render compact markdown charts: `.github/aw/asciicharts.md` -- Map CLI commands to MCP usage: `.github/aw/cli-commands.md` -- Choose workflow architecture and patterns: `.github/aw/patterns.md` -- Optimize token usage and cost: `.github/aw/token-optimization.md` -- Design long-running multi-agent research workflows: `.github/aw/multi-agent-research.md` - -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 or skill.