sickn33/agentic-awesome-skills/ai-agent-tool-routing
Claude Code and agent skill by sickn33/agentic-awesome-skills
- community
Checking that the SKILL.md file is still in the repository.
Use when designing or reviewing an AI agent tool registry or MCP router: document parameter schemas, caller authorization, execution limits, replay-safe retries and verification evidence.
Install
npx vskill@latest install sickn33/agentic-awesome-skills/ai-agent-tool-routingSKILL.md
The same SKILL.md was published earlier as sickn33/agentic-awesome-skills/ai-agent-tool-routing.
AI Agent Tool Routing Register
When to Use
- Define which tools an agent may call, their parameter schemas and runtime limits.
- Review a proposed tool registration before connecting it to an agent runtime.
- Document timeout, retry and authorization contracts for an existing router.
Scope and prerequisites
This skill produces a register and a verification plan. A register does not implement a router or establish that a tool is safe. Read the actual server/tool schema and the application's identity and permission model. Record observed configuration separately from proposed policy. Do not invoke registered tools, read credentials or enable a production registration merely to fill the table.
Workflow
- Identify a task, the calling principal/tenant, the intended tool and its read or
write effect. Tool names, model output and descriptions are not authorization.
- Read the advertised schema and implementation boundaries. Define required
fields, additional-field rejection, length/range limits and schema version. Prefer rejection to guessed or lossy coercion. Schema validation does not enforce row-level authorization, path containment or network restrictions.
- Describe identity propagation and server-side resource checks. Bind a request
to the verified principal; never let a tool argument select an arbitrary tenant.
- Set measured/project-approved timeout, rate, concurrency, response-size and
cost limits. Cancellation must propagate to downstream work where supported; returning a timeout alone does not prove a write did not finish.
- Classify retries by effect. Retry only classified transient failures within a
bounded budget. A write requires a verified server-side deduplication contract and reconciliation for ambiguous completion; a random key alone is insufficient.
- Define adversarial and failure cases: missing/unknown arguments, wrong tenant,
denied resources, unavailable tool, oversized response and late completion.
- Record actual test evidence and unresolved gaps. Keep status Draft until the
required checks ran against the exact runtime and schema revision. A register label never grants execution permission.
Field reference
| Field | Type | Example / interpretation | |
|---|---|---|---|
| tool_id | string, primary key | TOOL-001; use TEXT/VARCHAR, not a SERIAL integer | |
| canonical_name | string | read_document; match the advertised tool exactly | |
| server | string | project-docs local MCP; identify the actual installation | |
| invocation_mode | enum | synchronous / asynchronous / scheduled | |
| effect | enum | read / write; unknown effects stay unresolved | |
| parameter_schema | object or immutable reference | required document_id, unknown fields rejected | |
| authorization_policy | immutable reference | verified caller plus document ownership check | |
| runtime_limits | object | illustrative timeout 5000 ms, response 65536 bytes | |
| retry_contract | object | maximum attempts, transient classes, deduplication evidence | |
| status | enum | draft / tested / deprecated / blocked | |
| evidence | array of references | exact implementation revision, case IDs and observed results |
For SQL or Notion exports, retain these distinctions: textual IDs stay strings; objects/arrays need a deliberate JSON representation or related tables; dates must use actual date values. Do not treat a checklist boolean as a proved control. Escape spreadsheet formula-like text as text when exporting user-supplied fields.
Worked example
An agent needs a document summary. The proposed tool accepts only a document ID; the server obtains the caller from verified session context, not from arguments.
These limits are illustrative requirements, not measured service capabilities. The local schema can reject an added tenant_id, but an existing document ID still requires server-side ownership authorization. Expected negative checks: missing ID rejected, extra tenant rejected, another tenant's document denied, timeout reported without fabricated content. A positive authorized read alone does not close the negative cases. Promote to tested only with recorded actual results.
Limitations
- No RPC, blockchain, relayer or transaction-signing prerequisite applies to this
generic agent-tool register; a real tool may declare separate dependencies.
- This document supplies no production router, authentication adapter or sandbox.
- Declared retry/idempotency/rate limits must be enforced by the actual runtime.
- Never log sensitive arguments or full results by default. Use case IDs and
redacted error categories; preserve uncertainty after an ambiguous write.
Related skills
Read mcp-builder, mcp-server-security or error-handling-patterns when their actual scope fits the integration. They do not establish correctness by association.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/ai-agent-tool-routing/SKILL.md
Popularity
- Repository stars
- 47,174
- Repository forks
- 6,873
- 7-day trend score
- 54
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/sickn33/agentic-awesome-skills/ai-agent-tool-routing)