* 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>
