Skip to content

feat: add skill:// resource templates for Agent Skills discovery#2129

Draft
SamMorrowDrums wants to merge 1 commit intomainfrom
skills-resources
Draft

feat: add skill:// resource templates for Agent Skills discovery#2129
SamMorrowDrums wants to merge 1 commit intomainfrom
skills-resources

Conversation

@SamMorrowDrums
Copy link
Collaborator

@SamMorrowDrums SamMorrowDrums commented Mar 3, 2026

Summary

Spike PR adding MCP resource templates that expose Agent Skills from GitHub repositories via the skill:// URI scheme, following the skills-as-resources approach discussed in the MCP Skills Interest Group.

Resource Templates

Template Description
skill://{owner}/{repo}/{skill_name}/SKILL.md Fetch a skill's instruction content
skill://{owner}/{repo}/{skill_name}/_manifest JSON manifest listing files with repo:// URIs

The manifest composes with existing repo:// resource templates — each file entry includes a working repo:// URI that clients can read directly using the already-registered repository content resources.

Discovery Conventions

Skills are discovered using the Git Trees API (recursive), matching these directory conventions from the agentskills.io ecosystem:

Convention Example
skills/*/SKILL.md Standard agentskills.io spec
skills/{namespace}/*/SKILL.md Namespaced skills (multi-author repos)
plugins/*/skills/*/SKILL.md Plugin marketplace convention
*/SKILL.md Root-level skill directories

Hidden directories (.github/, etc.) and convention prefixes (skills/, plugins/) are excluded from root-level matching.

Completions

Full completions support wired into the CompletionsHandler:

  • owner / repo — reuses existing resolvers
  • skill_name — discovers available skills via tree search

Toolset

Registered under a new non-default skills toolset. Enable with:

--toolsets=skills
--toolsets=default,skills

Example manifest output

{
  "skill": "my-skill",
  "files": [
    {"path": "SKILL.md", "uri": "repo://owner/repo/contents/skills/my-skill/SKILL.md", "size": 256},
    {"path": "references/REFERENCE.md", "uri": "repo://owner/repo/contents/skills/my-skill/references/REFERENCE.md", "size": 1024}
  ]
}

References

Add MCP resource templates that expose Agent Skills (per agentskills.io
spec) from GitHub repositories via the skill:// URI scheme.

Resource templates:
- skill://{owner}/{repo}/{skill_name}/SKILL.md — fetch skill content
- skill://{owner}/{repo}/{skill_name}/_manifest — JSON manifest with
  repo:// URIs for each file, composing with existing repo:// resources

Discovery uses the Git Trees API to find SKILL.md files under known
paths (.github/skills/, skills/, .copilot/skills/).

Completions support for owner, repo (reusing existing resolvers), and
skill_name (discovers skills via tree search).

Registered under a new non-default 'skills' toolset. Enable with
--toolsets=skills or --toolsets=default,skills.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant