Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[aw] Workshop Explanatory Diagram Generator failed

Closed
  • Is something wrong?
#3,465 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

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

Research direction

Start with the failed run and the .github/workflows/workshop-explanatory-diagrams.md workflow, then review the failed github-brand skill reference and the skills documentation at docs/src/content/docs/reference/skills.mdx. Verify the repository reference, token access, commit, gh CLI support, and network conditions; done means the workflow completes successfully without the skill installation failure.

Written by the indexing model from the issue text.

Description

agentic-workflows
Workflow Failure

Workflow: Workshop Explanatory Diagram Generator
Branch: main
Run: https://github.com/githubnext/gh-aw-workshop/actions/runs/35174766668

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/35174766668
Manually invoke the agent

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

[!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:

safe-outputs:
  report-failure-as-issue: false

Generated from Workshop Explanatory Diagram Generator · copilot · 144 AIC · ◷

  • expires on Sep 24, 2026, 2:46 AM UTC
Dominant language
JavaScript
Stars
52
Forks
26
Avg merge
12h 58m
Merged PRs (30d)
15

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

  • No Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from githubnext/gh-aw-workshop

All issues in githubnext/gh-aw-workshop

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.