# Tool Selector

> Determines which tools, APIs, MCP actions, or system capabilities are required for a given task

- **Type:** Skill
- **Install:** `agentstack add skill-razaib-khan-forgeweave-tool-selector`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Razaib-khan](https://agentstack.voostack.com/s/razaib-khan)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Razaib-khan](https://github.com/Razaib-khan)
- **Source:** https://github.com/Razaib-khan/ForgeWeave/tree/main/src/forgeweave/templates/gemini/.gemini/skills/tool-selector

## Install

```sh
agentstack add skill-razaib-khan-forgeweave-tool-selector
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Tool Selector

## Purpose

Analyze a task and determine the optimal set of tools, MCP actions, APIs, and system capabilities needed to complete it. Prevents using the wrong tool for the job and ensures all required capabilities are available before execution starts.

## When to Use

- Starting a complex task that may need multiple tools
- The user asks "what tool should I use for X?"
- A skill or agent needs to determine its tooling requirements
- Before invoking the workflow-orchestrator to plan execution

## When Not to Use

- The tool is obvious from the task description
- Only one tool type is relevant (e.g., always "read" for documentation)
- The task is already executing and tools are already selected

## Inputs

| Input | Type | Required | Description |
|---|---|---|---|
| `task_description` | string | Yes | What needs to be done |
| `available_tools` | array | Yes | Tools, MCP actions, and capabilities available |
| `constraints` | string | No | Any restrictions on tool usage |

## Expected Outputs

| Output | Description |
|---|---|
| Required tools | Ordered list of tools needed |
| Tool configuration | Parameters, permissions, or setup needed per tool |
| Missing tools | Any required capabilities not available |

## Exact Workflow Steps

1. Analyze the task to determine what operations are needed (read, write, search, execute, etc.)
2. Map each operation to the appropriate available tool
3. Verify each selected tool has the required permissions
4. Identify any gaps where no available tool covers a needed operation
5. Return the tool list with ordering suggestions

## Required Checks

- [ ] Every required operation has a corresponding tool
- [ ] Selected tools have necessary permissions
- [ ] No tool is selected for operations it cannot perform

## Failure Modes

| Failure Condition | Response |
|---|---|
| No tool available for a needed operation | Report gap and suggest creating a new tool |
| Tool permissions insufficient | Report what permissions need to be added |
| Task is too vague to analyze | Ask clarifying questions |

## References

| Reference | Path |
|---|---|
| Available Tools (full registry) | `./skills/tool-selector/references/available-tools.md` |
| Workflow Orchestrator skill | `../workflow-orchestrator/SKILL.md` |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Razaib-khan](https://github.com/Razaib-khan)
- **Source:** [Razaib-khan/ForgeWeave](https://github.com/Razaib-khan/ForgeWeave)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-razaib-khan-forgeweave-tool-selector
- Seller: https://agentstack.voostack.com/s/razaib-khan
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
