Summary
This repo explores skills discovery and distribution through MCP primitives, but there is no complete Node.js example showing how to serve Agent Skills over MCP. Given the ecosystem around the TypeScript SDK and GitHub Copilot agents, a Node example would be highly valuable.
Proposal
Add a minimal but complete Node.js example that:
- Discovers skills from a local directory (e.g.
.agents/skills/).
- Parses
SKILL.md (YAML frontmatter + body).
- Exposes skills via MCP primitives:
resources/list / resources/read for skills and their resources.
tools/list / tools/call for skill activation.
- Demonstrates how a client (e.g. Copilot / MCP app) can:
- list available skills,
- activate a skill,
- read its bundled resources.
Implementation sketch
- Use
@modelcontextprotocol/sdk for the MCP server.
- Create an
examples/node-skills-server/ directory with:
server.ts / server.js (MCP server).
skills/ folder containing sample SKILL.md files and resources.
- Implement:
- directory enumeration (aligned with
resources/directory/read ADR),
- SKILL.md parsing with YAML frontmatter,
- mapping skills to MCP resources and tools.
Why this helps
- Gives Node developers a concrete reference for Skills-over-MCP.
- Makes it easier to experiment with the proposals in this repo.
- Aligns with existing TypeScript SDK and MCP Apps documentation.
I’m happy to implement this and open a PR if this direction looks good.
Summary
This repo explores skills discovery and distribution through MCP primitives, but there is no complete Node.js example showing how to serve Agent Skills over MCP. Given the ecosystem around the TypeScript SDK and GitHub Copilot agents, a Node example would be highly valuable.
Proposal
Add a minimal but complete Node.js example that:
.agents/skills/).SKILL.md(YAML frontmatter + body).resources/list/resources/readfor skills and their resources.tools/list/tools/callfor skill activation.Implementation sketch
@modelcontextprotocol/sdkfor the MCP server.examples/node-skills-server/directory with:server.ts/server.js(MCP server).skills/folder containing sampleSKILL.mdfiles and resources.resources/directory/readADR),Why this helps
I’m happy to implement this and open a PR if this direction looks good.