githubnext / githubnext/gh-aw-cao
[aw] Docs Diagrams failed
- Dominant language
- JavaScript
- Stars
- 3
- Forks
- 1
- Avg merge
- 49m
- Merged PRs (30d)
- 837
Description
### Workflow Failure
**Workflow:** [Docs Diagrams](https://github.com/githubnext/gh-aw-cao/blob/main/.github/workflows/docs-explanatory-diagrams.md)
**Branch:** main
**Run:** https://github.com/githubnext/gh-aw-cao/actions/runs/34566020797
**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-cao/actions/runs/34566020797
````
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 docs-explanatory-diagrams failure in https://github.com/githubnext/gh-aw-cao/actions/runs/34566020797`
> [!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 [Docs Diagrams](https://github.com/githubnext/gh-aw-cao/actions/runs/34566020797) · [◷](https://github.com/search?q=repo%3Agithubnext%2Fgh-aw-cao+is%3Aissue+%22gh-aw-workflow-id%3A+docs-explanatory-diagrams%22&type=issues)
> - [x] expires on Sep 18, 2026, 5:28 AM UTC
Contributor guide
Research direction
Start with .github/workflows/docs-explanatory-diagrams.md and the linked run 34566020797, then inspect the failed skill installation for the github/gh-aw-workshop/.github/skills/github-brand reference. Verify the repository, commit, token access, gh CLI support, and network conditions. Done means the Docs Diagrams workflow completes without the skill installation failure.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github-actions
- Domain
- ci-cd, devops
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100