Commit graph ext-skills/docs/skill-uri-scheme.md
Author SHA1 Message Date
Peter Alexander
71fc13af51
Update URI scheme proposal to decouple path from skill name (#70)
Aligns the proposed convention with the draft SEP:

- skill-path is a locator of one or more segments, not the skill name;
  identity lives in SKILL.md frontmatter
- authority component is the first path segment by RFC 3986 mechanics
  but carries no special semantics
- add no-nesting constraint (SKILL.md cannot be ancestor of another)
- resource templates are MAY and primarily user-facing via completion
- enumeration via resources/list is optional; clients must not treat
  an empty list as proof of absence
- add nested-path examples throughout

The survey section is unchanged; it's historical record.
2026-04-15 20:24:30 -07:00
Ola Hungerford
8a6ad39962
Update docs to reflect convention-to-SEP evolution; link to charter (#78) 2026-04-15 10:40:30 +02:00
Peter Alexander
36c5abddb7
Define well-known URI schemes and naming patterns for skill resources (#53)
* Add skill URI scheme proposal with survey of existing patterns (#44)

Survey 6 existing URI patterns (NimbleBrain, skilljack-mcp, skills-over-mcp,
FastMCP 3.0, Cloudflare well-known RFC, SEP-2076) and propose a recommended
skill:// URI convention for MCP skill resources. Cross-reference from
approaches.md Approach 6.

* Fix URI structure description: skill name is the authority, not a path segment

* Add versioning deferral note and multi-server collision handling

Address PR review feedback: note that versioning is intentionally deferred,
and recommend clients provide a read_resource tool with server name for
disambiguation when multiple servers expose the same skill URI.
2026-03-12 16:35:39 +00:00