Skip to content

Conversation

@tonyoconnell
Copy link
Contributor

No description provided.

Convert all MCP servers into on-demand Claude skills to eliminate
context pollution. This migration reduces token usage from ~15k to
~500 tokens maximum.

Changes:
- Created 7 MCP skills in .claude/skills/mcp/:
  • shadcn-components (shadcn/ui registry access)
  • stripe-payments (payment processing)
  • cloudflare-builds (deployment monitoring)
  • astro-docs (Astro documentation)
  • chrome-devtools (browser debugging)
  • figma-design (Figma design access)
  • cloudflare-docs (Cloudflare documentation)

- Updated agent frontmatter with agent-specific skills:
  • agent-frontend: shadcn, astro-docs, chrome-devtools
  • agent-designer: figma, chrome-devtools
  • agent-ops: cloudflare-builds, cloudflare-docs
  • agent-backend: NO MCP skills (zero context pollution)

Token savings:
- Default: 0 tokens (vs 15k always-loaded)
- When using 1 skill: ~550 tokens (vs 15k)
- Total savings: ~14,500 tokens (97% reduction)

Implementation details:
- Progressive loading: metadata (50t) → instructions (500t)
- Agent-specific access prevents unnecessary MCP context
- Skill files document when/how to use each MCP
- Compatible with existing /mcp-on toggle command

Based on Anthropic blog post:
https://www.anthropic.com/engineering/code-execution-with-mcp
Add mcp:convex-backend skill to provide agent-backend with Convex-
specific tooling while avoiding generic MCP context pollution.

Changes:
- Created mcp:convex-backend skill with:
  • Query data from Convex deployment
  • Inspect schema and tables
  • View function specifications
  • Check execution logs
  • Manage environment variables

- Updated agent-backend frontmatter:
  • Added skills: mcp:convex-backend
  • Backend now has ONLY Convex tooling (no generic MCPs)

- Updated MCP README:
  • Documented backend agent skills
  • Updated token savings: 16,500 (was 14,500)
  • Added backend usage examples

Benefits:
- Backend gets relevant Convex tools
- No generic MCP context pollution (shadcn, figma, etc.)
- On-demand loading: 0 tokens default, ~550 when querying
- Total savings: ~1,500 tokens per session

Based on: https://docs.convex.dev/ai/convex-mcp-server
These files are now properly ignored via .gitignore but were
previously tracked. Removing them from the index while keeping
them on disk.
Exclude from git tracking:
- .claude/hooks/.last-news-context (hook state)
- one/events/0-changes.md (auto-generated changes log)

These files are generated/modified by hooks and should not be
version controlled.
@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Nov 16, 2025

Deploying one-repo with  Cloudflare Pages  Cloudflare Pages

Latest commit: b716951
Status: ✅  Deploy successful!
Preview URL: https://a6dd75a4.one-repo.pages.dev
Branch Preview URL: https://claude-move-mcps-to-c-01envk.one-repo.pages.dev

View logs

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.

3 participants