[workshop-sync] workshop/29-skills-and-domain-knowledge.md: broken/unverified link to reference/custom-agent-for-aw
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 66/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- github-actions
- Domain
- documentation
Research direction
Open workshop/29-skills-and-domain-knowledge.md and find the SKILL.md link that points to reference/custom-agent-for-aw. Reuse the frontmatter skills anchor already linked earlier in the same file, or check that reference/copilot-custom-agents is the right page on the live gh-aw docs site. Done when the link resolves to a page that covers SKILL.md and the file has no other broken gh-aw links.
Written by the indexing model from the issue text.
Description
Workshop file reviewed
workshop/29-skills-and-domain-knowledge.md
Problem
The step links the phrase "SKILL.md" to a gh-aw docs URL that does not appear in the validated documentation URL map and has no corresponding slug in the known gh-aw docs sections:
Write a local [SKILL.md](https://github.github.com/gh-aw/reference/custom-agent-for-aw/)
This URL was not present in /tmp/gh-aw/data/doc-url-map-validated.json's doc_url_map, which only contains confirmed-reachable URLs. There is also no custom-agent-for-aw page in the known gh-aw docs section/slug inventory (reference pages include frontmatter, glossary, imports, inline-sub-agents, copilot-custom-agents, etc., but not custom-agent-for-aw).
Current correct syntax
The nearest matching documented page appears to be reference/copilot-custom-agents (https://github.github.com/gh-aw/reference/copilot-custom-agents/) or the skills: frontmatter section already correctly linked earlier in the same file (https://github.github.com/gh-aw/reference/frontmatter/#frontmatter-skills-skills). The exact correct target should be confirmed against the live gh-aw docs site before updating.
Suggested fix
Replace the custom-agent-for-aw URL with a verified gh-aw docs URL — either re-link to the existing frontmatter skills: anchor already used elsewhere in this file, or confirm and use the correct docs slug for SKILL.md authoring guidance (e.g. reference/copilot-custom-agents), and add it to the validated doc URL map for future sync checks.
Generated by 🔍 Workshop Sync Check · copilot · auto · 217.4 AIC · ⌖ 6.44 AIC · ⊞ 9.2K · ◷
- expires on Oct 14, 2026, 2:56 PM UTC
- Dominant language
- JavaScript
- Stars
- 53
- Forks
- 35
- Avg merge
- 1d 5h
- Merged PRs (30d)
- 16
Getting set up
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
- 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 githubnext/gh-aw-workshop
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
githubnext/gh-aw-workshop#4638 ·
Maintainers usually reply within 1 day
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
githubnext/gh-aw-workshop#4635 ·
Maintainers usually reply within 1 day
-
[guidelines] side-quest-21-01-sub-agent-syntax.md: checklist checkbox count exceeds 10-item limitOpendocumentation guidelines
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
githubnext/gh-aw-workshop#4409 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
githubnext/gh-aw-workshop#3109 · 11 comments ·
Maintainers usually reply within 1 day
-
accessibility bug
Difficulty 2/5 1-2 days Newbie friendliness 68/100
githubnext/gh-aw-workshop#2744 · 10 comments ·
Maintainers usually reply within 1 day
All issues in githubnext/gh-aw-workshop
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
keyxmakerx/Chronicle#1469 ·
Maintainers usually reply within 1 day
-
enhancement good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 83/100
suradet-ps/codeframe#40 ·
Maintainers usually reply within 1 day
-
data
Difficulty 1/5 Under an hour Newbie friendliness 74/100
gaseous-project/hasheous#637 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
gramps-project/gramps-web#1549 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100