evalstate · evalstate · Jun 2, 2026 · May 29, 2026 · May 29, 2026 · May 29, 2026
diff --git a/docs/docs/assets/social/acp.png b/docs/docs/assets/social/acp.png
diff --git a/docs/docs/assets/social/acp/customizing_agents.png b/docs/docs/assets/social/acp/customizing_agents.png
diff --git a/docs/docs/assets/social/agents.png b/docs/docs/assets/social/agents.png
diff --git a/docs/docs/assets/social/agents/defining.png b/docs/docs/assets/social/agents/defining.png
diff --git a/docs/docs/assets/social/agents/defining/agent_cards.png b/docs/docs/assets/social/agents/defining/agent_cards.png
diff --git a/docs/docs/assets/social/agents/defining/python_api.png b/docs/docs/assets/social/agents/defining/python_api.png
diff --git a/docs/docs/assets/social/agents/instructions.png b/docs/docs/assets/social/agents/instructions.png
diff --git a/docs/docs/assets/social/agents/plugins.png b/docs/docs/assets/social/agents/plugins.png
diff --git a/docs/docs/assets/social/agents/prompting.png b/docs/docs/assets/social/agents/prompting.png
diff --git a/docs/docs/assets/social/agents/running.png b/docs/docs/assets/social/agents/running.png
diff --git a/docs/docs/assets/social/agents/tool_runner.png b/docs/docs/assets/social/agents/tool_runner.png
diff --git a/docs/docs/assets/social/agents/workflows.png b/docs/docs/assets/social/agents/workflows.png
diff --git a/docs/docs/assets/social/getting_started.png b/docs/docs/assets/social/getting_started.png
diff --git a/docs/docs/assets/social/getting_started/installation.png b/docs/docs/assets/social/getting_started/installation.png
diff --git a/docs/docs/assets/social/guides/batch-processing.png b/docs/docs/assets/social/guides/batch-processing.png
diff --git a/docs/docs/assets/social/guides/codex.png b/docs/docs/assets/social/guides/codex.png
diff --git a/docs/docs/assets/social/guides/core-concepts.png b/docs/docs/assets/social/guides/core-concepts.png
diff --git a/docs/docs/assets/social/guides/hf-dev.png b/docs/docs/assets/social/guides/hf-dev.png
diff --git a/docs/docs/assets/social/guides/privacy_filter.png b/docs/docs/assets/social/guides/privacy_filter.png
diff --git a/docs/docs/assets/social/guides/skills.png b/docs/docs/assets/social/guides/skills.png
diff --git a/docs/docs/assets/social/guides/structured-outputs.png b/docs/docs/assets/social/guides/structured-outputs.png
diff --git a/docs/docs/assets/social/guides/tui.png b/docs/docs/assets/social/guides/tui.png
diff --git a/docs/docs/assets/social/index.png b/docs/docs/assets/social/index.png
diff --git a/docs/docs/assets/social/mcp.png b/docs/docs/assets/social/mcp.png
diff --git a/docs/docs/assets/social/mcp/elicitations.png b/docs/docs/assets/social/mcp/elicitations.png
diff --git a/docs/docs/assets/social/mcp/mcp-oauth.png b/docs/docs/assets/social/mcp/mcp-oauth.png
diff --git a/docs/docs/assets/social/mcp/mcp-server.png b/docs/docs/assets/social/mcp/mcp-server.png
diff --git a/docs/docs/assets/social/mcp/mcp-ui.png b/docs/docs/assets/social/mcp/mcp-ui.png
diff --git a/docs/docs/assets/social/mcp/mcp_display.png b/docs/docs/assets/social/mcp/mcp_display.png
diff --git a/docs/docs/assets/social/mcp/openai-apps-sdk.png b/docs/docs/assets/social/mcp/openai-apps-sdk.png
diff --git a/docs/docs/assets/social/mcp/resources.png b/docs/docs/assets/social/mcp/resources.png
diff --git a/docs/docs/assets/social/mcp/skills-over-mcp.png b/docs/docs/assets/social/mcp/skills-over-mcp.png
diff --git a/docs/docs/assets/social/mcp/state_transfer.png b/docs/docs/assets/social/mcp/state_transfer.png
diff --git a/docs/docs/assets/social/mcp/types.png b/docs/docs/assets/social/mcp/types.png
diff --git a/docs/docs/assets/social/models.png b/docs/docs/assets/social/models.png
diff --git a/docs/docs/assets/social/models/internal_models.png b/docs/docs/assets/social/models/internal_models.png
diff --git a/docs/docs/assets/social/models/llm_providers.png b/docs/docs/assets/social/models/llm_providers.png
diff --git a/docs/docs/assets/social/models/model_overlays.png b/docs/docs/assets/social/models/model_overlays.png
diff --git a/docs/docs/assets/social/models/models_reference.png b/docs/docs/assets/social/models/models_reference.png
diff --git a/docs/docs/assets/social/models/providers/additional.png b/docs/docs/assets/social/models/providers/additional.png
diff --git a/docs/docs/assets/social/models/providers/aliyun.png b/docs/docs/assets/social/models/providers/aliyun.png
diff --git a/docs/docs/assets/social/models/providers/anthropic.png b/docs/docs/assets/social/models/providers/anthropic.png
diff --git a/docs/docs/assets/social/models/providers/azure.png b/docs/docs/assets/social/models/providers/azure.png
diff --git a/docs/docs/assets/social/models/providers/bedrock.png b/docs/docs/assets/social/models/providers/bedrock.png
diff --git a/docs/docs/assets/social/models/providers/deepseek.png b/docs/docs/assets/social/models/providers/deepseek.png
diff --git a/docs/docs/assets/social/models/providers/generic.png b/docs/docs/assets/social/models/providers/generic.png
diff --git a/docs/docs/assets/social/models/providers/google.png b/docs/docs/assets/social/models/providers/google.png
diff --git a/docs/docs/assets/social/models/providers/groq.png b/docs/docs/assets/social/models/providers/groq.png
diff --git a/docs/docs/assets/social/models/providers/huggingface.png b/docs/docs/assets/social/models/providers/huggingface.png
diff --git a/docs/docs/assets/social/models/providers/openai.png b/docs/docs/assets/social/models/providers/openai.png
diff --git a/docs/docs/assets/social/models/providers/openrouter.png b/docs/docs/assets/social/models/providers/openrouter.png
diff --git a/docs/docs/assets/social/models/providers/xai.png b/docs/docs/assets/social/models/providers/xai.png
diff --git a/docs/docs/assets/social/ref/about.png b/docs/docs/assets/social/ref/about.png
diff --git a/docs/docs/assets/social/ref/azure-config.png b/docs/docs/assets/social/ref/azure-config.png
diff --git a/docs/docs/assets/social/ref/batch.png b/docs/docs/assets/social/ref/batch.png
diff --git a/docs/docs/assets/social/ref/class_reference.png b/docs/docs/assets/social/ref/class_reference.png
diff --git a/docs/docs/assets/social/ref/cmd_switches.png b/docs/docs/assets/social/ref/cmd_switches.png
diff --git a/docs/docs/assets/social/ref/config_file.png b/docs/docs/assets/social/ref/config_file.png
diff --git a/docs/docs/assets/social/ref/docs_automation.png b/docs/docs/assets/social/ref/docs_automation.png
diff --git a/docs/docs/assets/social/ref/export_command.png b/docs/docs/assets/social/ref/export_command.png
diff --git a/docs/docs/assets/social/ref/fast_agent_ai_articles.png b/docs/docs/assets/social/ref/fast_agent_ai_articles.png
diff --git a/docs/docs/assets/social/ref/generated_docs.png b/docs/docs/assets/social/ref/generated_docs.png
diff --git a/docs/docs/assets/social/ref/go_command.png b/docs/docs/assets/social/ref/go_command.png
diff --git a/docs/docs/assets/social/ref/open_telemetry.png b/docs/docs/assets/social/ref/open_telemetry.png
diff --git a/docs/docs/assets/social/welcome.png b/docs/docs/assets/social/welcome.png
diff --git a/docs/docs/assets/tui/skills-over-mcp.cast b/docs/docs/assets/tui/skills-over-mcp.cast
diff --git a/docs/docs/guides/skills.md b/docs/docs/guides/skills.md
@@ -26,6 +26,11 @@ When valid `SKILL.md` files are found:
 
     Skills installed from any git repo (local or remote) can be automatically updated.
 
+!!! note "Skills over MCP"
+
+    Thanks to Ola Hungerford, fast-agent has early access support for MCP SEP-2640: [Skills over MCP](../mcp/skills-over-mcp.md)
+
+
 ## Installing Skills
 
 Skills can be installed, updated and removed from the CLI or TUI with the `skills` command.

diff --git a/docs/docs/mcp/skills-over-mcp.md b/docs/docs/mcp/skills-over-mcp.md
@@ -0,0 +1,80 @@
+---
+title: Skills over MCP
+social:
+  title: Skills over MCP
+  tagline: Install Agent Skills from MCP servers that implement SEP-2640.
+  description: Install Agent Skills from MCP servers that implement SEP-2640.
+  alt: fast-agent social card - Skills over MCP
+---
+
+`fast-agent` supports the registry and installation portion of
+[SEP-2640: Skills Extension](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/93d7a9ddb20d4b3594f4a1be7508ee47f0718f17/seps/2640-skills-extension.md).
+SEP-2640 is still a draft, so this support is intentionally scoped: an MCP
+server can act as a skills registry when it advertises the
+`io.modelcontextprotocol/skills` extension capability, and `fast-agent` installs
+selected skills into the normal managed skills directory.
+
+When a connected MCP server advertises this capability, `fast-agent` shows it as
+an MCP-backed skills registry. Opening `/skills registry` reads
+`skill://index.json` and lists installable `skill-md` or archive entries that
+include a valid `sha256:` digest. Installing a selected entry downloads the
+artifact, verifies its SHA-256, then writes the skill into the normal managed
+skills directory. Installed skills then behave like other local skills and
+include MCP server provenance plus the verified artifact digest in their sidecar
+metadata.
+
+## Trying it
+
+Run or connect to a SEP-2640-enabled MCP server. This example uses the hosted
+Hugging Face MCP Server:
+
+```text
+/mcp connect --name hf https://huggingface.co/mcp
+/mcp
+/skills registry
+/skills registry hf
+/skills available
+/skills add <number|name>
+```
+
+`/mcp` shows when SEP-2640 Skills over MCP is enabled and points you to
+`/skills registry` to select the MCP server as the current install source.
+Listings show `integrity: SHA256 checked` for installable MCP skills.
+
+<div
+  class="fa-terminal-demo"
+  data-fa-asciinema-cast="../../assets/tui/skills-over-mcp.cast"
+  data-fa-asciinema-cols="96"
+  data-fa-asciinema-rows="22"
+  data-fa-asciinema-poster="npt:0:02"
+  data-fa-asciinema-speed="1"
+  data-fa-asciinema-idle-time-limit="1.3"
+  data-fa-asciinema-fit="width"
+>
+  <div class="fa-terminal-theme-switch" aria-label="Terminal theme">
+    <button type="button" data-fa-terminal-theme="auto">Auto</button>
+    <button type="button" data-fa-terminal-theme="light">Light</button>
+    <button type="button" data-fa-terminal-theme="dark">Dark</button>
+  </div>
+  <div data-fa-asciinema-target></div>
+</div>
+
+<!--
+Cast asset:
+- Source: docs/docs/assets/tui/skills-over-mcp.cast
+- Regenerate: uv run scripts/docs.py cast-build skills-over-mcp
+- Replay locally: asciinema play docs/docs/assets/tui/skills-over-mcp.cast
+-->
+
+## Current scope
+
+This implementation uses MCP as a registry for installation. It does not expose
+MCP-served skill resources directly to the model, and it does not make active
+skills read supporting files from the MCP server. That deeper resource-loading
+workflow is planned separately.
+
+`/skills update` can compare the installed artifact digest with the current MCP
+registry digest and apply a verified update when the server publishes a newer
+artifact. The top-level `fast-agent skills` CLI remains marketplace/file/GitHub
+oriented; select MCP registries from an interactive session after connecting the
+MCP server.
diff --git a/docs/docs/ref/docs_automation.md b/docs/docs/ref/docs_automation.md
@@ -61,6 +61,7 @@ uv run scripts/docs.py cast-build tui-shell
 uv run scripts/docs.py cast-build model-picker
 uv run scripts/docs.py cast-build skills-direct-install
 uv run scripts/docs.py cast-build skills-slash-commands
+uv run scripts/docs.py cast-build skills-over-mcp
 ```
 
 The `tui-shell` scenario records `fast-agent` starting with shell access and a visible model
@@ -71,6 +72,9 @@ The `model-picker` scenario records `fast-agent go` opening the startup model pi
 the provider/model lists with arrow keys.
 The skills scenarios record direct install and update-check flows from a temporary local git
 repository, using either CLI commands or `/skills` slash commands in the TUI.
+The `skills-over-mcp` scenario connects to `https://huggingface.co/mcp`, selects the `hf`
+MCP-backed registry, searches the registry, and installs a SHA256-verified skill. Override
+`FAST_AGENT_SKILLS_MCP_DEMO_SERVER` to record against a local SEP-2640 server.
 
 By default, cast recordings stop by killing the tmux session after the final demonstrated action,
 so the user-facing recording does not show a trailing `/exit`. Set