Skip to content

Add experimental MCP skill publication - #1

Closed
irvinebroque wants to merge 3 commits into
mainfrom
codex/sep-2640-mcp-skills
Closed

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

Conversation

@irvinebroque

@irvinebroque irvinebroque commented Jun 21, 2026

Copy link
Copy Markdown
Owner

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

Copy link
Copy Markdown
Owner Author

Opened the intended upstream PR here: FredKSchott#4. Closing this fork-targeted duplicate to keep the review in the right repo.

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