kalash33/kstack/agent-tools

Claude Code and agent skill by kalash33/kstack

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Build MCP servers and agent tools. Covers tool design, MCP protocol, input validation, error handling, and testing. Use when: "build a tool", "MCP server", "agent tool", "function calling", "give the agent access to", or when agents need new capabilities.

Install

npx vskill@latest install kalash33/kstack/agent-tools

SKILL.md

The same SKILL.md was published earlier as kalash33/kstack/agent-tools.

/agent-tools — Tool Builder

Tools are how agents interact with the world. Build them right.

When to Use

  • Agent needs a new capability (API access, file ops, browser, etc.)
  • Building an MCP server
  • Designing function-calling interfaces
  • Wrapping an API for agent use

Tool Design Principles

  1. One tool, one job. Don't combine search + filter + format.
  2. Clear descriptions. The LLM reads them to decide when to call.
  3. Typed inputs. Validate everything. Agents will send garbage.
  4. Useful errors. "Invalid date format, expected YYYY-MM-DD" not "Error".
  5. Idempotent when possible. Agents retry. Don't double-charge.

MCP Server Template

typescript
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
const server = new McpServer({ name: "my-tool", version: "1.0.0" });
server.tool(
"search_docs",
"Search documentation by keyword. Returns top 5 matches.",
{ query: z.string().describe("Search query") },
async ({ query }) => {
const results = await searchIndex(query);
return { content: [{ type: "text", text: JSON.stringify(results) }] };
}
);
const transport = new StdioServerTransport();
await server.connect(transport);

Python Tool Template

python
def search_docs(query: str) -> str:
"""Search documentation by keyword. Returns top 5 matches.
Args:
query: The search query string
Returns:
JSON string with matching documents
"""
if not query or len(query) > 500:
return json.dumps({"error": "Query must be 1-500 characters"})
results = index.search(query, limit=5)
return json.dumps({"results": results})

Testing Tools

python
# Test happy path
assert "results" in json.loads(search_docs("authentication"))
# Test edge cases
assert "error" in json.loads(search_docs(""))
assert "error" in json.loads(search_docs("x" * 501))
# Test with actual agent
response = agent.run("Find docs about authentication")
assert "search_docs" in response.tool_calls

Chaining

  • Before: /agent-design (identifies what tools are needed)
  • After: /agent-build (wires tools into agents)

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/kalash33/kstack/agent-tools/badge)](https://verified-skill.com/skills/kalash33/kstack/agent-tools)

Something wrong with this skill or its page? Tell us.