ext-skills/docs/archive/related-work.md
Ola Hungerford 5adfff5952
Clean and and re-organize repo docs (#146)
* docs: point README and AGENTS.md at the released spec and official docs

SEP-2640 is Final and the extension ships from specification/stable/skills.mdx,
so the README now leads with a Specification section linking the spec file,
the official docs page (modelcontextprotocol.io/extensions/skills/overview),
the published SEP, and the client matrix. The experimental banner is replaced
with a note that docs/ holds working documents; the charter, pulls, and issues
links move off the redirecting experimental-ext-skills / charter URLs.

AGENTS.md no longer names the SEP PR as the source of truth; it points agents
at the stable spec page and describes the decision-log flow against that file.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: accepted spec changes land in a draft revision, not the stable file

The stable specification is a released snapshot. README and AGENTS.md now say
accepted decision-log proposals go into a draft revision that ships as a new
release, matching the ext-tasks specification layout.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: move pre-release design documents to docs/archive

SEP-2640 is Final, so docs/ now holds only living working documents. Eight
historical documents move to docs/archive with an index explaining what each
was and what superseded it: the SEP baseline copy, why-and-when, use-cases,
approaches, skill-uri-scheme, glossary, client-mcp-support (superseded by the
official client matrix), and agent-plugins-analysis.

Files the published SEP links to by path (decisions, experimental-findings,
open-questions, problem-statement, rationale, related-work, skill-meta-keys)
stay in place so those links keep working. Cross-links are rewritten and
verified; the README contents table is trimmed to match.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: archive open-questions and skill-meta-keys

Both are pre-release documents whose outcomes live in the decision log and
the specification. The published SEP links to them by path; a companion
change in modelcontextprotocol/modelcontextprotocol repoints those links.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: fix sibling links inside archived open-questions and skill-meta-keys

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: keep only the decision log and rationale in docs/

threat-model, experimental-findings, findings-template, problem-statement,
and related-work move to docs/archive with index rows. The candidates
tracker and the archived client-support survey are removed in favor of the
official extension client matrix, and links to them are repointed there.

README drops the Why and Problem Statement sections, which duplicate the
SEP's Motivation and the official overview page. CONTRIBUTING routes new
implementation findings to GitHub issues.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: fix sibling links inside newly archived documents

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: add a concise implementations list

One table each for servers/SDKs and hosts, one line per entry, replacing the
retired candidates tracker and the related-work implementation tables. Seeded
from those plus PR #141 and issue #144.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: put tracking links in the Status column of the implementations list

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: add a vendor/community category to the implementations list

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: replace the interim reference package with the TypeScript SDK row

The @olaservo/ext-skills package is retired in favor of first-class skills
APIs in the TypeScript SDK (typescript-sdk#2798, phase 1 in #2818). The
archived related-work page now points at implementations.md for current
information.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: drop pre-SEP rows from the implementations list

They are already recorded in the archived related-work page; the list now
points there instead. FastMCP stays because its row tracks the migration to v1.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: add official SDK progress, Tachyon, and Inspector 2.6.0 to implementations

From the WG Discord channel and the SDK repos as of 2026-09-15: Go, TypeScript,
Python, and C# SDKs all have open SEP-2640 PRs (Go passes conformance); the
conformance suite merged; Inspector 2.6.0 shipped skills verification; Tachyon
reports a server implementation. Adds an "in progress" status for open PRs.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: track Goose host support via the official issue

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: only tag community rows in the implementations list

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: tag MCP-project rows as official in the implementations list

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: split the implementations list into SDKs, servers, and hosts

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs: add MCPJam Inspector to hosts

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* Revise implementations table format and content

Updated the implementations table to include language and status columns.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Correct links and clarify documentation references

Updated links to SEP-2640 and clarified document references.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
Co-authored-by: Sambhav Kothari <sambhavs.email@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
2026-09-16 06:56:20 +02:00

11 KiB

Related Work

SEPs and Proposals

Proposal Venue Description
SEP-2640 (Skills Extension) MCP Spec This WG's proposed extension: skills served over MCP using the Resources primitive and skill:// URI scheme (v1 baseline text)
PR #2527 MCP Spec Recommend clients expose resource read to models — prerequisite for the resources-based skills approach
skills.json format proposal MCP Registry Skills metadata in registry schema
SEP-2093 MCP Spec Resource Contents Metadata and Capabilities: scoped resources/list, per-resource capabilities, resources/metadata endpoint — rejected (labeled upstream)
SEP-2076 MCP Spec Agent Skills as a first-class MCP primitive — closed (2026-02-24, without merge)

Client support for the extension is tracked on the official extension client matrix. The implementation tables below are frozen; implementations.md has more recent information.

Working Group Member Implementations

Work by WG leads and active participants that directly implements the group's core patterns: SKILL.md with YAML frontmatter, skill:// resource URIs, and progressive disclosure via MCP primitives.

Implementation Author URL Notes
skilljack-mcp Ola Hungerford github.com/olaservo/skilljack-mcp SKILL.md, skill:// resources, tools, and prompts; progressive disclosure (index→skill→files); file watching for dynamic updates; audience annotations
skills-over-mcp Keith Groves github.com/keithagroves/skills-over-mcp SKILL.md, skill:// resources with progressive disclosure (index→skill→documents); Zod validation against Agent Skills spec
skillsdotnet Peder HP github.com/PederHP/skillsdotnet C# implementation: SKILL.md, skill:// resources, load_skill tool for progressive disclosure, manifest with file hashes; published on NuGet; compatible with FastMCP 3.0

Alternative Approaches

Work by WG members and MCP maintainers that explores skills over MCP through different technical approaches than the core SKILL.md / skill:// pattern.

Implementation Author Organization URL Notes
skillful-mcp Kurtis Van Gent Google Cloud github.com/kurtisvg/skillful-mcp Progressive disclosure via 4 lightweight tools (list_skills, use_skill, read_resource, execute_code); wraps downstream MCP servers as skills using mcp.json config rather than SKILL.md; sandboxed code execution via Monty
Astronomer agents Kaxil Naik Astronomer github.com/astronomer/agents Production skills catalog for Apache Airflow (blueprint, migration, warehouse-init); uses SKILL.md frontmatter but distributed via plugin marketplace rather than MCP resources; demonstrates real-world skills adoption at scale
mcpGraph skill Bob Dickinson TeamSpark.ai github.com/TeamSparkAI/mcpGraph Declarative YAML-based tool orchestration engine (directed graphs of MCP tool calls); includes SKILL.md files as documentation; explores a complementary "no-code composition" approach to skill authoring

Other Community Implementations

External projects building on skills patterns or integrating skills into frameworks.

Implementation Author URL Notes
FastMCP 3.0 Skills FastMCP gofastmcp.com/servers/providers/skills Native skills provider (#2694)
PydanticAI Skills PydanticAI pydantic/pydantic-ai#3780 Agent skills with tools-based approach
mcp-execution bug-ops github.com/bug-ops/mcp-execution Compiles MCP servers into skill packages; --dry-run preview
mcp-cli philschmid github.com/philschmid/mcp-cli Wraps MCP servers as CLI for progressive disclosure
my-cool-proxy karashiiro github.com/karashiiro/my-cool-proxy MCP gateway with skills as resources via Lua scripts; result offloading, session persistence (v1.6.x)
NimbleBrain skills repo NimbleBrain github.com/NimbleBrainInc/skills Monorepo with .skill artifact format
NimbleBrain registry NimbleBrain registry.nimbletools.ai Registry with skill metadata support
NimbleBrain skill:// servers NimbleBrain github.com/NimbleBrainInc skill:// resource colocation examples: mcp-ipinfo, mcp-webfetch, mcp-pdfco, mcp-folk, mcp-brave-search
Kiro powers directory Kiro github.com/kirodotdev/powers Plugin directory bundling skills + MCP servers; active catalog (AWS, GCP migration, SAM, etc.)
mcpkit (ext/skills) Sri Panyam github.com/panyam/mcpkit Go SDK, server + host: SKILL.md, skill:// resources, progressive disclosure (skill://index.json catalog + host load_skill tool); per-supporting-file digests with verified reads, resource-fetch size + per-server byte budget, resources/directory/read; no code-execution surface (enforced by a build-failing test); released in v0.3.0

Projects that illustrate the problem space or use adjacent patterns.

Project Author URL Notes
chrome-devtools-mcp Google (ChromeDevTools) github.com/ChromeDevTools/chrome-devtools-mcp Real-world example of the problem: skills/ folder requires separate install path
Strands Agents MCP server AWS github.com/strands-agents/mcp-server Docs-as-MCP: TF-IDF search + doc fetch
AWS MCP server AWS docs.aws.amazon.com/aws-mcp/… retrieve_agent_sop (skills) + call_aws (tool)

Specifications and Standards

  • Agent Skills Standard: agentskills.io
  • Agent Skills Discovery RFC v0.2.0 (Matt Silverlock / Cloudflare): github.com/cloudflare/agent-skills-discovery-rfc — Domain-level skill discovery using /.well-known/agent-skills/ (RFC 8615). Defines index.json with progressive disclosure, skill-md and archive distribution types, $schema versioning, SHA-256 content integrity, and archive safety requirements. Complementary to MCP-level discovery: .well-known answers "what skills does this domain publish?" while MCP answers "how does the agent consume them at runtime?"
  • Skill dependency declaration: agentskills/agentskills#110 — Discusses how skills should declare their tool/server dependencies
  • Apache Airflow AIP-91 (MCP integration): cwiki.apache.org/…/AIP-91+-+MCP

Integrity, Content Addressing, and Attestation

Related work on establishing and verifying the integrity, authenticity, and provenance of skill resources.

  • skill-set format (draft) (Harry Martin / flocker.md): skill-set.md — Transport-agnostic manifest specification and CLI for named, versioned collections of skills assembled from disparate sources. Defines deterministic whole-skill content hashes and set-level roll-ups, lockfiles, receipt-time content verification, and optional out-of-band URL-fragment pins. Complementary to SEP-2640: provides prior art for deriving a single content address from a complete {uri, digest} resource set and for future whole-skill or multi-skill attestations. See the reference directory for an immutable example.

Background Reading

  • Anthropic's guidance on progressive disclosure: Equipping agents for the real world with agent skills
  • "MCP and Skills: Why Not Both?" (Kurtis Van Gent): kvg.dev/posts/20260125-skills-and-mcp/ — Frames MCP (connectivity) and Skills (context saturation) as complementary; discusses hybrid approaches
  • "Skills Over MCP" (Angie Jones, Agentic AI Foundation): aaif.io/blog/skills-over-mcp/ — "Ship the manual with the product": bundle Agent Skills with MCP servers so agents get both tools and instructional guidance. Describes the working group's proposal (SEP-2640) — skill:// resources, a skill://index.json catalog for lightweight discovery, and progressive disclosure of full instructions on demand
  • "Progressive Discovery in MCP, Part 2" (Sam Morrow, GitHub MCP Server maintainer): sam-morrow.com/blog/progressive-discovery-in-mcp-part-2 — Advocates skills-based progressive discovery to solve tool bloat: skill:// resources, deferred tool loading via provider mechanisms (Anthropic tool_reference, OpenAI defer_loading), and the io.modelcontextprotocol/tools metadata namespace. Grounded in lessons from GitHub's MCP Server (100+ tools, 12M weekly calls)
  • Conceptual spec visualization (Keith Groves): enact-465fb1fc.mintlify.app/specification/draft/server/skills — "What if" exploration
  • llms.txt convention: llmstxt.org — Convention for making documentation LLM-accessible; used by MCPDoc in a way similar to how skills work
  • AWS Agent SOPs: docs.aws.amazon.com/…/agent-sops — Pre-built operational workflows as skill-like guidance
  • Video background: youtube.com/watch?v=CEvIs9y1uog