-
Notifications
You must be signed in to change notification settings - Fork 126
Description
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 barescripts/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.*toscripts/convert.* - 19 references changed from
./convert.*toscripts/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