Skip to main content

require-relative-skill-links

Require Copilot skill definition files to use relative Markdown links for workspace resources.

Rule catalog ID: R052

Targeted pattern scope​

  • .github/skills/**/SKILL.md
  • .claude/skills/**/SKILL.md

What this rule reports​

  • root-relative or otherwise non-relative workspace file links in a skill body

Why this rule exists​

Skills frequently reference supplementary Markdown files, scripts, and local resources. Relative links keep those references portable and aligned with the repository-local nature of project skills.

❌ Incorrect​

---
name: review
description: Review code changes.
---
See [guide](/docs/review.md).

✅ Correct​

---
name: review
description: Review code changes.
---
See [guide](guide.md).

Further reading​