Skip to content

Fix broken documentation links to skill instruction files - #10579

Merged
pelikhan merged 4 commits into
mainfrom
copilot/fix-broken-chat-instructions-link
Jan 18, 2026
Merged

pelikhan merged 4 commits into
mainfrom
copilot/fix-broken-chat-instructions-link

Conversation

Copilot AI commented Jan 18, 2026 •

Copy link
Copy Markdown
Contributor

Documentation referenced non-existent instruction files at .github/instructions/*.instructions.md (404). These files were relocated to skills/*/SKILL.md but the documentation wasn't updated.

Changes

  • Fixed broken URLs in docs/src/content/docs/setup/agentic-authoring.mdx:

    • .github/instructions/dictation.instructions.md → skills/dictation/SKILL.md
    • .github/instructions/agentic-chat.instructions.md → skills/agentic-chat/SKILL.md
  • Enhanced link checking in .github/workflows/link-check.yml:

    • Added .mdx file extension to workflow triggers
    • Added separate check step for docs/ folder with .md,.mdx support
    • Previously only checked reports/ folder

This prevents future broken links in documentation from going undetected.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • telemetry.astro.build
    • Triggering command: /opt/hostedtoolcache/node/24.12.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)
    • Triggering command: /opt/hostedtoolcache/node/24.12.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build infocmp -1 xterm-color gh /usr/bin/infocmp /ref/tags/v8 --json (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

Copy chat instructions link in docs is broken.

  • add static checking of links
  • fix links

See https://githubnext.github.io/gh-aw/setup/agentic-authoring/#designing-tasks-with-chatgpt


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 3 commits January 18, 2026 14:21
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
- Update dictation and agentic-chat URLs to point to correct SKILL.md files
- Add .mdx file checking to link-check workflow
- Add separate docs folder link checking step

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix broken chat instructions link in documentation Fix broken documentation links to skill instruction files Jan 18, 2026
Copilot AI requested a review from pelikhan January 18, 2026 14:36
@pelikhan
pelikhan marked this pull request as ready for review January 18, 2026 14:37
@pelikhan
pelikhan merged commit e2aba86 into main Jan 18, 2026
70 checks passed
@pelikhan
pelikhan deleted the copilot/fix-broken-chat-instructions-link branch January 18, 2026 14:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants