Description
During testing, the agent received summarized skill content without the original URLs and then started guessing skill paths. This can happen when URL-fetching or summarization tools do not preserve Markdown links.
Because links are the main mechanism for moving through the skill tree, the landing page should make the navigation model explicit. For users who install skills locally, AGENTS.md should include the same guidance because the agent framework can inject it automatically.
Proposed change
Update the skills landing page and AGENTS.md to clarify how agents should navigate the skill tree:
- Read the relevant
SKILL.md file directly.
- Follow the links in
SKILL.md files as the navigation mechanism.
- Do not guess URL paths.
- When fetching
SKILL.md files via a URL tool, preserve Markdown links exactly as written.
Expected outcome
Agents are less likely to lose navigation links, guess skill URLs, or follow invalid paths. The URL-based workflow becomes more robust through landing page guidance, while local installations are covered through AGENTS.md.
Description
During testing, the agent received summarized skill content without the original URLs and then started guessing skill paths. This can happen when URL-fetching or summarization tools do not preserve Markdown links.
Because links are the main mechanism for moving through the skill tree, the landing page should make the navigation model explicit. For users who install skills locally,
AGENTS.mdshould include the same guidance because the agent framework can inject it automatically.Proposed change
Update the skills landing page and
AGENTS.mdto clarify how agents should navigate the skill tree:SKILL.mdfile directly.SKILL.mdfiles as the navigation mechanism.SKILL.mdfiles via a URL tool, preserve Markdown links exactly as written.Expected outcome
Agents are less likely to lose navigation links, guess skill URLs, or follow invalid paths. The URL-based workflow becomes more robust through landing page guidance, while local installations are covered through
AGENTS.md.