Skip to content

chore(skills): standardize script path references in SKILL.md files #767

@katriendg

Description

@katriendg

Summary

Standardize all script path references in SKILL.md files to use bare relative paths from the skill root directory, removing ./ prefixes and repo-root-relative paths that break portability.

Motivation

The agentskills.io specification and Anthropic canonical skill examples (docx, pptx, pdf) consistently use bare scripts/ paths without ./ prefix. Repo-root-relative paths like ./.github/skills/experimental/video-to-gif/scripts/convert.sh break when skills are distributed via extension, CLI, or personal skill directories (~/.copilot/skills/, ~/.agents/skills/).

Our prompt-builder.instructions.md already states: "All paths within a skill must be relative to the skill root, never repo-root-relative." The SKILL.md files were not following this guidance.

When distributed as a VS Code extension, the skill lives under ~/.vscode/extensions/, not .github/skills/. When installed as a CLI plugin, it lives under ~/.copilot/installed-plugins/. Using the skill root-relative scripts/ path ensures that all script references resolve correctly regardless of distribution context.

Changes

pr-reference SKILL.md

  • 15 script path references changed from ./scripts/ to bare scripts/ prefix
  • Affects Quick Start, Parameters Reference, and Additional Scripts Reference sections

video-to-gif SKILL.md

  • 2 repo-root-relative Quick Start paths changed from ./.github/skills/experimental/video-to-gif/scripts/convert.* to scripts/convert.*
  • 19 references changed from ./convert.* to scripts/convert.* across Script Reference, Examples, and Parameters sections

Verification

  • Grep search confirms zero remaining ./scripts/, ./convert.*, or .github/skills/.*/scripts/ references across all SKILL.md files
  • Both files verified via read to confirm correct content after changes

Files Modified

  • .github/skills/shared/pr-reference/SKILL.md
  • .github/skills/experimental/video-to-gif/SKILL.md

Metadata

Metadata

Assignees

Labels

maintenanceMaintenance work, no version bump

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions