Skip to content

Clarify skill navigation instructions for URL and local usage #81

@szabosteve

Description

@szabosteve

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No fields configured for Task.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions