githubnext / githubnext/gh-aw-workshop

[aw] Workshop Explanatory Diagram Generator failed

Open
#3,286 0 comments 0 reactions 0 assignees View on GitHub
agentic-workflows
Dominant language
JavaScript
Stars
47
Forks
19
Avg merge
8h 54m
Merged PRs (30d)
50

Description

### Workflow Failure

**Workflow:** [Workshop Explanatory Diagram Generator](https://github.com/githubnext/gh-aw-workshop/blob/main/.github/workflows/workshop-explanatory-diagrams.md)
**Branch:** main
**Run:** https://github.com/githubnext/gh-aw-workshop/actions/runs/34733237346

**Skill Installation Failed**: One or more frontmatter skills could not be installed before the agent ran. This typically happens when:

- The skill repository does not exist or is not accessible with the configured token
- The skill reference is invalid or points to a non-existent branch/tag/commit
- The `gh` CLI version is too old (requires a recent version that supports `gh skill install`)
- Network connectivity to the skill host is blocked by the firewall

**Failed skills:**
- `github/gh-aw-workshop/.github/skills/github-brand@56127b6381f0f1d976231bb924dadcbae18858de`: The process '/usr/bin/gh' failed with exit code 1

To resolve this, verify that:
1. The skill repository reference is correct (e.g. `owner/repo` or `owner/repo/skill/path@sha`)
2. The token configured for the skill has read access to the skill repository
3. The skill repository and branch/tag/commit exist on GitHub

See: https://github.com/github/gh-aw/blob/main/docs/src/content/docs/reference/skills.mdx

### Action Required

**Assign this issue to an agent** to debug and fix the issue.

Debug with any coding agent

Use this prompt with any coding agent (GitHub Copilot, Claude, Gemini, etc.):

````
Debug the agentic workflow failure using https://raw.githubusercontent.com/github/gh-aw/main/debug.md

The failed workflow run is at https://github.com/githubnext/gh-aw-workshop/actions/runs/34733237346
````

Manually invoke the agent

Debug this workflow failure using your favorite Agent CLI and the `agentic-workflows` prompt.

- Start your agent
- Load the `agentic-workflows` skill from `.github/skills/agentic-workflows/SKILL.md` or
- Type `debug the agentic workflow workshop-explanatory-diagrams failure in https://github.com/githubnext/gh-aw-workshop/actions/runs/34733237346`

> [!TIP]
>
> Stop reporting this workflow as a failure
>
> To stop a workflow from creating failure issues, set `report-failure-as-issue: false` in its frontmatter:
> ```yaml
> safe-outputs:
> report-failure-as-issue: false
> ```
>
>

> Generated from [Workshop Explanatory Diagram Generator](https://github.com/githubnext/gh-aw-workshop/actions/runs/34733237346) · copilot · 169 AIC · [◷](https://github.com/search?q=repo%3Agithubnext%2Fgh-aw-workshop+is%3Aissue+%22gh-aw-workflow-id%3A+workshop-explanatory-diagrams%22&type=issues)
> - [x] expires on Sep 20, 2026, 2:43 AM UTC

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with .github/workflows/workshop-explanatory-diagrams.md and the linked Actions run to inspect the failed skill installation. Read docs/src/content/docs/reference/skills.mdx and .github/skills/agentic-workflows/SKILL.md, then verify the referenced skill, token access, and gh CLI requirements. Done means the workflow can install the skill and complete successfully.

Written by the indexing model from the issue text.

Assessment

Tech stack
github, github-actions
Domain
ci-cd, devops, tooling
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.