Skills: relative file paths in SKILL.md are not resolved
Resolved 💬 3 comments Opened May 5, 2026 by npalladium Closed May 9, 2026
Summary
When a skill's SKILL.md references a file using a relative path (e.g. references/style-guide.md), the LLM has no way to resolve it because it doesn't know the skill's install directory. This causes the agent to use Search/Glob instead of Read, which fails to find the file.
Reproduction
- Create a skill with a
references/subdirectory containing a file - Reference it in SKILL.md with a relative path: `
Seereferences/style-guide.md` - Install and invoke the skill
- The agent searches for the file and gets 0 results
Expected behavior
The skill system should resolve relative paths in SKILL.md to absolute paths before injecting the prompt, or expose the skill's base directory to the LLM so it can construct the correct path.
Workaround
Instruct the LLM to locate the file dynamically: "Read the file references/style-guide.md located in this skill's directory"
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗