Skip to content

Add a Node.js example implementation of Skills‑over‑MCP #107

Description

@donny-devops

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:

  1. Discovers skills from a local directory (e.g. .agents/skills/).
  2. Parses SKILL.md (YAML frontmatter + body).
  3. Exposes skills via MCP primitives:
    • resources/list / resources/read for skills and their resources.
    • tools/list / tools/call for skill activation.
  4. 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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Status
    In progress

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions