ntaffzii Tool-Agnostic MCP Routing
Use this skill when the current environment may have different tool names than this repository.
Capability Map
Translate task needs into capabilities:
| Need | Capability |
|---|---|
| Inspect code | file search, file read |
| Choose tool scope | toolset recommender, toolset inspector, registry |
| Edit code | patch, file write, code edit |
| Verify code | command runner, test runner |
| Hand off blocked commands | user-run script generator, command handoff planner, script risk validator |
| Plan validation | validation planner, command policy checker |
| Inspect repository state | version control status, diff, log |
| Control repository state | branch creator, checkout, stage, unstage, commit |
| Understand project shape | project stack, scripts, manifest inspection |
| Understand project docs | documentation index, README/docs reader, context bundle |
| Build repo map | repository index builder, symbol/file search, related-file finder |
| Compare external MCP ideas | MCP catalog search, repo pattern comparison, local adaptation planner |
| Inspect dependencies | package manager detection, dependency manifest reader, lockfile status |
| Inspect containers | Docker CLI checker, Dockerfile inspector, Compose service inspector, Docker validation planner |
| Inspect API surface | route finder, endpoint extractor, OpenAPI spec reader, API config hints |
| Inspect data layer | schema finder, migration finder, ORM model extractor, database config hints |
| Query configured database | read-only SQL planner, SQL risk explainer, read-only Postgres runner |
| Inspect configuration | config finder, env key lister, secret hygiene checker |
| Inspect tests | test file finder, framework detector, source-to-test mapper |
| Inspect CI | CI file finder, GitHub Actions job inspector, validation command extractor |
| Inspect local tasks | TODO/FIXME scanner, roadmap file finder |
| Inspect dependency risk | unpinned dependency finder, high-risk dependency name checker |
| Scan repository security | secret scanner, dangerous command scanner, env exposure scanner, security report |
| Inspect release readiness | changelog finder, version detector, release checklist |
| Snapshot before broad edits | backup planner, zip snapshot creator |
| Edit structured registries | JSON/YAML/TOML reader, path getter, structured path patcher |
| Preserve project memory | memory saver, memory search, project memory summary |
| Build personal context | typed memory saver, context pack builder, memory handoff generator |
| Search long-running context | vector or semantic memory search, related-memory finder, memory cluster summarizer |
| Build RAG context | text chunker, RAG provider planner, embedding request planner, source metadata preserver |
| Inspect GitHub metadata | workflow finder, Actions inspector, PR description drafter |
| Inspect GitHub API data | repo reader, issue reader, PR reader, PR file lister, check status reader |
| Inspect browser/UI readiness | browser capability checker, static HTML inspector, smoke-check planner |
| Map a web page | HTML page mapper, heading/link/form/button extractor, element finder by label |
| Inspect live UI | Playwright runtime checker, page inspector, screenshot capture |
| Automate live UI | Playwright click, fill, text assertion, console/network failure inspector, accessibility snapshot, persistent session runner |
| Inspect design files | Figma auth checker, design file summary, token/component extractor, frontend implementation planner |
| Try safe experiments | sandbox workspace creator, snippet compiler, sandbox run planner |
| Understand tool failures | audit log, policy denial inspection |
| Audit MCP safety | risk classifier, mutating tool finder, policy coverage checker |
| Research current facts | web search, URL fetch |
| Capture public web pages | provider-neutral static fetch, browser capture, optional cloud scraper adapter, social public-only reader |
| Research finance markets | market quote reader, crypto price reader, finance-news planner, watchlist summarizer, position-risk calculator |
| Work with Notion | Notion auth checker, page search, page reader, note/update payload planner |
| Bridge Obsidian and Notion | Obsidian note inspector, Notion payload planner, Markdown conversion planner, sync checklist |
| Work with chat apps | Slack/Discord config checker, message search, channel summarizer, reply drafter, action-item extractor |
| Triage inbox | email config checker, email search planner, email summarizer, action extractor, reply drafter |
| Plan calendar | calendar config checker, event summarizer, daily plan builder, meeting prep drafter, follow-up extractor |
| Plan issue work | issue reference parser, issue draft builder, task breakdown, issue update planner |
| Inspect UI | browser automation, screenshot |
| Work with images/video | media inspection, frame extraction |
| Improve prompts | prompt analysis, rewrite, scoring |
| Save progress | handoff, document write |
Workflow
Identify the next job
- What must be learned, changed, verified, or created?
Choose capability
- Pick the needed capability before choosing a tool.
- If several tools can do it, prefer the least risky one.
Map to current tools
- Read available tool names and descriptions.
- If registry/introspection tools exist, call them before guessing.
- Select the closest matching tool.
- If no tool exists, explain the missing capability and use a text-only fallback.
Execute safely
- Inspect before editing.
- Preview before broad writes when possible.
- Run narrow validation before broad validation.
Record mapping
- In the final answer, say what capability was used.
- Mention exact tool names only when useful to the user.
Rules
- Do not assume this repo's
mcp-tools/exists. - Do not call tools by guessed names.
- Do not use a high-risk tool when a read-only tool is enough.
- If tool descriptions are ambiguous, choose the safer read-only action first.
Output Format
End with:
- Needed capability
- Tool used or fallback
- Result
- Verification