Skip to content

Add experimental MCP skill publication - #4

Draft
irvinebroque wants to merge 3 commits into
FredKSchott:mainfrom
irvinebroque:codex/sep-2640-mcp-skills
Draft

Add experimental MCP skill publication#4
irvinebroque wants to merge 3 commits into
FredKSchott:mainfrom
irvinebroque:codex/sep-2640-mcp-skills

Conversation

@irvinebroque

@irvinebroque irvinebroque commented Jun 21, 2026

Copy link
Copy Markdown

Summary

Adds an experimental MCP/SEP-2640 publication mode alongside the existing Agent Skills well-known discovery output.

With skills({ mcp: true }) or the object form, Astro sites can publish:

  • /.well-known/mcp/skills/index.json with SEP-style frontmatter, url, digest, and optional archives[]
  • direct static routes for every file in each skill directory
  • generated .tar.gz archive alternatives for multi-file skills
  • a .tree.json helper manifest that static MCP servers can use to implement resources/directory/read

The existing /.well-known/agent-skills/index.json output remains enabled by default, so a site can support both the Agent Skills well-known discovery proposal and MCP resource publication.

Related work

Validation

  • pnpm build
  • pnpm build in example/
  • Verified generated Agent Skills discovery digests against emitted artifacts
  • Verified generated MCP index digests against emitted SKILL.md resources
  • Verified archive layout has SKILL.md at the archive root

@irvinebroque
irvinebroque force-pushed the codex/sep-2640-mcp-skills branch from a61eb39 to 04e47a6 Compare June 21, 2026 03:44
@irvinebroque irvinebroque changed the title [codex] Add experimental MCP skill publication mode Add experimental MCP skill publication Jun 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant