Skip to content

Add skills resources to Cloudflare API code mode server#165

Draft
irvinebroque wants to merge 1 commit into
cloudflare:mainfrom
irvinebroque:codex/cloudflare-api-skills-extension
Draft

Add skills resources to Cloudflare API code mode server#165
irvinebroque wants to merge 1 commit into
cloudflare:mainfrom
irvinebroque:codex/cloudflare-api-skills-extension

Conversation

@irvinebroque

@irvinebroque irvinebroque commented Jun 21, 2026

Copy link
Copy Markdown

Summary

Adds draft MCP Skills extension support to the Cloudflare API Code Mode MCP server.

This assumes Cloudflare Skills are published by developers.cloudflare.com under /.well-known/mcp/skills/, following the artifact shape from cloudflare/cloudflare-docs#31606 and FredKSchott/astro-skills#4.

Related Astro plugin implementation: irvinebroque/astro-skills#1.

Changes

  • Advertise capabilities.extensions["io.modelcontextprotocol/skills"] with directoryRead: true
  • Serve skill://index.json from the published skills index
  • Serve skill://... skill files from published docs artifacts
  • Implement resources/directory/read using .tree.json
  • Support optional archive resources advertised by index.json
  • Register skills only for the default Code Mode server
  • Leave codemode=false behavior unchanged

Compatibility

This is additive for MCP clients:

  • Existing clients can ignore the new resources and extension capability
  • Non-Code Mode MCP server behavior is unchanged
  • The server does not depend on GitHub API traversal or raw GitHub file fetches at runtime

Some of the skills.ts adapter code is likely temporary or simplifiable once the Model Context Protocol TypeScript SDK adds native support for the Skills extension and its capability/resource helpers.

Verification

  • npm run check

Passed format, lint, typecheck, and all tests.

@mattzcarey

Copy link
Copy Markdown
Contributor

love this thanks

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.

2 participants