Instruction file imported from kod88vn/my-recipes (
.github/instructions/mcp.instructions.md). Copyright stays with the author.
This repository models MCP servers as a separate layer from skills.
Source-of-truth rule:
- Main reusable content should live outside
.github. .githubshould expose symlinks or rendered compatibility views into the main content rather than becoming the primary editable store.- For skills, prefer editing
skills/and project-scaffold source templates, then link.github/skillsto that source.
When changing MCP-aware code:
- Treat skills as guidance and MCP servers as capabilities.
- Put server metadata in
mcp/<server-id>/server.json. - Put client-specific rendered config fragments in
mcp/<server-id>/templates/. - Update installer behavior in
lib/mcp-installer.jsrather than scattering config writes. - Keep
.skill-lib/project.jsonand rendered.vscode/mcp.jsonin sync. - Validate scaffold output after MCP changes.
When changing scaffold behavior:
- Root
.github/skillsmust still be created. - Root
.vscode/mcp.jsonmust be rendered when MCP is enabled. - Root
.skill-lib/project.jsonmust reflect the enabled MCP servers and bundles.
Do not treat MCP descriptors as if they were SKILL.md files.