Commit graph ext-skills/docs/approaches.md
Author SHA1 Message Date
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
Ola Hungerford
e4de42cf8d
Add notes to docs from Discord and office hours discussions (#36)
* Add community insights from Discord threads and meeting notes

Distill Discord discussions (Feb 14-24) and Feb 26 office hours into
existing docs:

- New findings: NimbleBrain skill:// resource consolidation, skill
  reliability/adherence issues across implementations
- Expanded approaches with distribution/provenance considerations,
  resources adoption insight, and domain-level discovery (.well-known)
- Expanded open questions on dependencies and distribution trust
- Added Cloudflare Agent Skills Discovery RFC and NimbleBrain
  reference implementations to related work

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Remove trust note since its already mentioned in the doc separately

* Clarify attribution for community insights on skill dependencies in open questions

* Refine findings on model skill adherence and community workarounds

* Remove outdated comparison section and streamline evaluation insights in experimental findings

* Remove unnecessary blank line in experimental findings documentation

* Add SEP-2093 proposal to related work documentation

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 12:12:01 -08:00
olaservo
6b097dd5b6 Restore Bob's original comment 2026-02-07 20:47:19 -07:00
olaservo
cd1abddf19 Add ecosystem complexity principle and reorganize community input
Co-Authored-By: rektide <53243+rektide@users.noreply.github.com>
2026-02-07 20:41:33 -07:00
olaservo
62e32ef658 Enhance design principles and open questions documentation with additional community insights on skills as context and discoverability challenges
Co-Authored-By: rektide <53243+rektide@users.noreply.github.com>
2026-02-07 20:22:31 -07:00
olaservo
3e58697d52 Refine design principles section to clarify emerging considerations from community discussions 2026-02-07 20:22:30 -07:00
olaservo
4665899d89 Enhance design principles and open questions documentation with community insights on skills as context and discoverability challenges 2026-02-07 20:22:30 -07:00
olaservo
e98465f6d8 Add section on central tension between convention and protocol extension in approaches documentation 2026-02-04 07:13:19 -07:00
olaservo
4d96a40cf4 Enhance documentation with key elements and community input for skills approach and open questions 2026-02-04 06:21:47 -07:00
olaservo
7cf9b69664 Add design principles and community input to approaches, open questions, and use cases documents 2026-02-03 06:30:12 -07:00
olaservo
89d3575a39 Add approaches doc 2026-02-02 08:21:11 -07:00