agentic-workflows skill template ships a relative link that is broken in consumer repos
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 76/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- go, markdown
- Domain
- cli, documentation
Research direction
The broken link is in the shipped template pkg/cli/data/agentic_workflows_skill.md, around line 25, in the 'go directly to Model and engine misconfiguration' sentence. Read how gh aw embeds files from pkg/cli/data so you know this is the copy consumers receive. Change the relative ../../aw/ link to an absolute github.com/github/gh-aw URL, as the issue suggests. Done means the link resolves outside this repo and a check under pkg/cli fails on any relative ../ link in pkg/cli/data/.
Written by the indexing model from the issue text.
Description
Summary
The agentic-workflows skill that gh aw installs into consumer repos has a relative link that resolves to a file that doesn't exist there:
https://github.com/github/gh-aw/blob/main/pkg/cli/data/agentic_workflows_skill.md?plain=1#L25
go directly to [Model and engine misconfiguration](../../aw/debug-agentic-workflow.md#model-and-engine-misconfiguration)
The same file says the .github/aw/* guides should be loaded "from github/gh-aw (they are not available locally)". The link works inside this repo (.github/skills/agentic-workflows/SKILL.md → .github/aw/), but not in consumer repos:
- installed at
.agents/skills/agentic-workflows/SKILL.md, it resolves to.agents/aw/debug-agentic-workflow.md, which doesn't exist - installed at
.github/skills/agentic-workflows/SKILL.md, it resolves to.github/aw/debug-agentic-workflow.md, which consumers don't have either
So the new "go directly to Model and engine misconfiguration" route is a dead link for every consumer (we saw it after gh aw upgrade to v0.91.12).
Suggested fix
Make the link absolute in the shipped template, e.g.
[Model and engine misconfiguration](https://github.com/github/gh-aw/blob/main/.github/aw/debug-agentic-workflow.md#model-and-engine-misconfiguration)
or point it at .github/aw/debug-model-engine-misconfiguration.md. A check that shipped templates under pkg/cli/data/ contain no relative ../ links would catch regressions.
- Dominant language
- Go
- Stars
- 5.4k
- Forks
- 584
- Avg merge
- 3h 56m
- Merged PRs (30d)
- 810
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- Ships a Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from github/gh-aw
-
automation cookie
Difficulty 1/5 Under an hour Newbie friendliness 68/100
github/gh-aw#68990 · 2 comments ·
Maintainers usually reply within 1 day
-
automated conformance safe-outputs
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
Maintainers usually reply within 1 day
-
goroutineresourceleak (81st linter): paren_unwrap_gap across lock/cancel/channel detection, day oneOpencookie sergo
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
github/gh-aw#68591 · 1 comment ·
Maintainers usually reply within 1 day
-
agentic-workflows cascade-suspected
Difficulty 4/5 3-5 days Newbie friendliness 22/100
Maintainers usually reply within 1 day
-
agentic-workflows cascade-suspected
Difficulty 4/5 1-2 days Newbie friendliness 15/100
Maintainers usually reply within 1 day
Similar issues
-
documentation hacktoberfest priority: low skill: good first issue status: ready for dev
Difficulty 2/5 Half a day Newbie friendliness 85/100
hyperledger-labs/fabric-smart-client#2142 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
numberly/vault-db-injector#107 ·
Maintainers usually reply within 1 day
-
area/import kind/bug
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
Maintainers usually reply within 1 day
-
[DOC] Wrong sg_egress_ports range in the Terraform Databricks Guide for AWS Hub & Spoke with Network FirewallPossibly taken @akhil9tiet claimed this today. Opendocs
Difficulty 1/5 Under an hour Newbie friendliness 72/100
databricks/terraform-provider-databricks#6080 · 1 comment ·
Maintainers usually reply within 3 days
-
kind/documentation
Difficulty 2/5 1-3 hours Newbie friendliness 80/100
kubernetes-sigs/dra-driver-nvidia-gpu#1569 ·
Maintainers usually reply within 1 day