You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Add cross-reference links from docs to tracking issues
Link open questions, approaches, use cases, and experimental findings
to their corresponding GitHub issues so readers can find the active
discussion without hunting through the issues list.
- open-questions.md: "Tracked in" and "See also" links on Q1, Q4, Q5,
Q7, Q8, Q12, Q13
- approaches.md: "See also" links on Approach 3, distribution section,
and sampling variant
- use-cases.md: "See also" links on UC3 (multi-server) and UC4
(progressive disclosure)
- experimental-findings.md: contribution template note and skill
reliability link
Supersedes modelcontextprotocol#56.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@@ -99,6 +100,8 @@ Several design considerations have been suggested in community discussion and pr
99
100
-**Git-based distribution:** Versioned distribution via git (tags, pinned refs) can be viable without a formal registry. Clare Liguori (AWS) noted that Terraform operated without a formal registry for a long time — Feb 26 office hours.
100
101
-**Domain-level discovery:** The [Agent Skills Discovery RFC](https://github.com/cloudflare/agent-skills-discovery-rfc) proposes `/.well-known/skills/` for organizations to publish skills at predictable URLs with content integrity (SHA-256 digests). This is complementary to MCP — it handles discovery and distribution while MCP handles runtime consumption.
101
102
103
+
**See also:**[#44](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/44) — Define well-known URI schemes and naming patterns for skill resources
104
+
102
105
**Community input:**
103
106
104
107
> "Installless/temporary/ephemeral skill availability while server is installed feels like a good pattern. Clients could optionally offer to permanently install." — [Sam Morrow](https://github.com/SamMorrowDrums) (GitHub), via Discord
@@ -115,6 +118,8 @@ Instead of exposing skill tools to the main agent, use MCP's Sampling with Tools
Copy file name to clipboardExpand all lines: docs/experimental-findings.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,7 @@
1
1
# Experimental Findings
2
2
3
+
> **Contributing findings?** See [#50](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/50) for the contribution template proposal.
@@ -86,3 +88,5 @@ Multiple community members have independently reported that models do not reliab
86
88
> "Skills are ephemeral and/or time decaying — it clicks once and then give it some time and they lose the plot." — Kryspin (qcompute), via Discord
87
89
88
90
> "I've seen lazy load skills with various degrees of success, actually looks like it might be model specific… [best pattern is] putting them in with a subagent that similarly named or mentions the topic in their description." — Kryspin (qcompute), via Discord
91
+
92
+
**See also:**[#37](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/37) — Compare skill delivery mechanisms: file-based vs MCP-based
Copy file name to clipboardExpand all lines: docs/open-questions.md
+16Lines changed: 16 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,6 +2,8 @@
2
2
3
3
## 1. Is this a registry problem or an MCP server problem?
4
4
5
+
> **See also:**[#44](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/44) — Define well-known URI schemes and naming patterns for skill resources
6
+
5
7
Should skills be discoverable through registry metadata ("if you install this server, also install this skill") or contained within the MCP server itself?
6
8
7
9
A third option is emerging: domain-level discovery via `/.well-known/skills/` (see [Agent Skills Discovery RFC](https://github.com/cloudflare/agent-skills-discovery-rfc)). This decouples skill discovery from both registries and MCP servers — an organization publishes skills at a predictable URL on its own domain. This could complement MCP-level discovery rather than replace it: `.well-known` handles "find available skills," MCP handles "load and use them at runtime."
@@ -18,6 +20,8 @@ Or is the separation between "primitive server" and "skill that uses the primiti
18
20
19
21
## 4. How should skills relate to multiple servers?
20
22
23
+
> **Tracked in:**[#39](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/39) — Research skill dependency declaration and host-mediated resolution
24
+
21
25
A skill orchestrating tools from several servers can't live in any single server's instructions.
22
26
23
27
**Related:**[agentskills/agentskills#110](https://github.com/agentskills/agentskills/issues/110) — Discusses how skills should declare their tool/server dependencies. The lack of explicit dependency configuration makes multi-server skill execution unpredictable: if required servers and tools aren't already loaded, the skill can't reliably execute.
@@ -36,6 +40,9 @@ The agentskills.io spec currently has a freeform [compatibility field](https://a
36
40
37
41
## 5. Do clients actually leverage skills when presented via MCP?
38
42
43
+
> **Tracked in:**[#38](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/38) — Survey client resource-loading support across major MCP clients
## 8. What could MCP reasonably change so that it will be the obvious choice for new formats?
54
63
64
+
> **See also:**[#54](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/54) — The case for custom metadata instead of a URI convention
65
+
55
66
— [Keith Groves](https://github.com/keithagroves)
56
67
57
68
**Community input:**
@@ -94,6 +105,8 @@ Note: Some apps like Claude Code have started to indicate in the skill frontmatt
94
105
95
106
## 12. Why not just resources?
96
107
108
+
> **See also:**[#54](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/54) — The case for custom metadata instead of a URI convention, [#55](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/55) — Define recommended _meta keys for skill resources
109
+
97
110
**Core Maintainer input:**
98
111
99
112
> "Why not just resources? That feels like the obvious implementation since skills are just files and resources already exist to expose files. i.e. just expose skills as resources the same as they're currently exposed on the filesystem and then just use the existing Agent Skills specification — client can find skills using resources/list to find SKILL.md files." — [Peter Alexander](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2076#discussion_r2736299627)
@@ -108,6 +121,9 @@ See also [Approaches](approaches.md) for more notes on using resources.
108
121
109
122
## 13. What is the optimal relationship between skills and MCP?
Skills already work as simple files that agents load directly. Adding MCP to the process should provide clear value beyond what standalone skills already offer.
Copy file name to clipboardExpand all lines: docs/use-cases.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -30,6 +30,8 @@ Skills that leverage tools from multiple off-the-shelf servers where you can't (
30
30
31
31
Beyond multi-server tool orchestration, skills themselves may be composable — one skill depending on another skill's output or behavior. This extends the dependency model beyond tool availability to skill availability, and raises questions about declarative dependency metadata. See [Open Question 4](open-questions.md#4-how-should-skills-relate-to-multiple-servers) for the emerging proposal on host-mediated dependency resolution.
32
32
33
+
**See also:**[#39](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/39) — Skill dependency declaration, [#45](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/45) — Worked examples for multi-server composition
34
+
33
35
## 4. Progressive Disclosure
34
36
35
37
Skills broken into linked sets of files for effective context management, loaded progressively as the agent needs them rather than all at once.
@@ -46,6 +48,8 @@ Skills broken into linked sets of files for effective context management, loaded
46
48
47
49
**Related:**[Anthropic's guidance on progressive disclosure](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
48
50
51
+
**See also:**[#45](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/45) — Worked examples for progressive disclosure, [#40](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/40) — Client-side reference implementation for model-driven resource loading
52
+
49
53
## 5. Server-Skill Pairing
50
54
51
55
Servers that are difficult or impossible to use effectively without an accompanying skill.
0 commit comments