apply-clean-mcp-architecture
Apply Clean MCP Architecture
Architectural standard for TypeScript MCP servers built with mcp-use/server. Decides where files live, what each layer may import, what bootstrap wires, and how the discipline is enforced. Mechanical recipes (exact APIs, auth, transports, widgets) live in build-mcp-use-server.
When to use this skill
Trigger on phrases or contexts like:
- "where should this tool / gateway / presenter / port live?"
- "refactor this monolithic
src/tools/*.tsinto clean layers" - "audit this MCP server's architecture" / "PR review for layering"
- "set up
dependency-cruiserfor an mcp-use server" - "why is
mcp-useimported fromdomain/orapplication/?" - "scaffold a greenfield
mcp-use/serverrepo with proper folders" - "
process.envis being read all over the codebase — fix the seam" - "design ports, adapters, and provider error classification"
Do NOT use this skill when:
More from yigitkonur/skills-by-yigitkonur
run-research
Use skill if you are answering one technical research question with current web evidence, Reddit practitioner experience, and source-backed synthesis, optionally fanned out across parallel subagents.
42run-agent-browser
Use skill if you are driving the agent-browser CLI for ad hoc browser automation — @ref snapshots, sessions, forms, extraction, screenshots, headed/stealth, or provider runs.
38publish-npm-package
Use skill if you are publishing to npm via GitHub Actions release workflow with trusted publishing, NPM_TOKEN, provenance, semantic-release, changesets, release-please, or fixing npm publish CI.
35init-agent-config
Use skill if you are creating, auditing, or migrating CLAUDE.md, AGENTS.md, or REVIEW.md instruction files, folder-scoped agent guidance, or cross-agent companion entrypoints.
34build-mcp-use-server
Use skill if you are building TypeScript MCP servers with mcp-use/server — server.tool, response helpers, ctx.auth, sessions, transports, widgets, Inspector, deploy.
34build-skills
Use skill if you are creating or substantially revising a Claude skill and need workspace-first evidence, remote comparison, and repo-fit synthesis before writing SKILL.md.
32