modelcontextprotocol/ext-skills
Watch
1
0
Fork
You've already forked ext-skills
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: add combined skills glossary (#104)

Browse source 
* docs: add combined skills glossary

Adds docs/glossary.md with working definitions for Skills Over MCP
terminology, addressing #51. Combines the strongest definitions from
three open glossary PRs (#103, #101, #93):

- Core terms covering all 10 terms requested in #51 (skill, instruction,
  primitive, resource, convention, context, progressive disclosure,
  control model, first-class primitive, server/skill author, discovery),
  with Agent Skills alignment/divergence noted where relevant.
- Distribution and ecosystem terms (skill resource, skill:// URI, skill
  metadata, server-skill pairing, multi-server composition, ephemeral
  availability, provenance).
- Cross-referenced from the README documents table.

Co-authored-by: kiku-jw <25382531+kiku-jw@users.noreply.github.com>
Co-authored-by: luohui1 <187920557+luohui1@users.noreply.github.com>
Co-authored-by: EfeDurmaz16 <75971010+EfeDurmaz16@users.noreply.github.com>

* docs: align glossary with latest SEP-2640 and decision log

Reconcile the combined glossary against the current SEP-2640 text and
the Working Group decision log:

- First-class primitive: reflect that the WG considered and declined a
  skills/list method (2026-06-05), keeping skills as Resources, rather
  than framing it as a still-open option.
- Add Skill index (skill://index.json), Archive, and Directory listing
  (resources/directory/read) terms — settled spec concepts that were
  missing (decisions 2026-04-19, 2026-06-05, 2026-06-09).
- Skill metadata: ground in SKILL.md frontmatter and note _meta is
  reserved for transport-specific keys under io.modelcontextprotocol.skills/
  (decision 2026-03-16); index copies frontmatter verbatim.
- Provenance: note the WG treats it as a distribution/plugin-layer
  concern, not standardized skill metadata (decision 2026-03-16).
- References: add SEP-2640 and the Decision Log.

* docs: incorporate June 16 WG meeting clarifications

From the 2026-06-16 Skills Over MCP WG meeting notes (postdates the
decision log):

- Skill metadata: distinguish the two reserved namespaces — the
  io.modelcontextprotocol/ prefix inside the frontmatter metadata block
  vs. the io.modelcontextprotocol.skills/ prefix on resource _meta.
- Add Compatibility term: the frontmatter compatibility field is
  free-text and LLM-evaluated (not a deterministic gate); hosts screen
  execution-requiring skills by convention, and the WG holds that
  execution/environment signaling belongs in the Agent Skills spec.

* docs: update glossary terms to SEP-2640 v1 (skills/list, skills/get, digests; archives removed)

---------

Co-authored-by: kiku-jw <25382531+kiku-jw@users.noreply.github.com>
Co-authored-by: luohui1 <187920557+luohui1@users.noreply.github.com>
Co-authored-by: EfeDurmaz16 <75971010+EfeDurmaz16@users.noreply.github.com>
This commit is contained in:
Ola Hungerford 2026-08-28 09:51:35 -07:00 • committed by GitHub
commit 47fc34a92e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 51 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
README.md
View file

@ -45,6 +45,7 @@ See [problem-statement.md](docs/problem-statement.md) for full details.
| [Client MCP Support](docs/client-mcp-support.md) | Survey of model-facing MCP resource loading and SEP-2640 support across open-source clients |
| [Decision Log](docs/decisions.md) | Record of key decisions with context and rationale |
| [Rationale](docs/rationale.md) | Design rationale for SEP-2640's Resources-based skills extension |
| [Glossary](docs/glossary.md) | Working definitions for key Skills Over MCP terms |
## Contributing