What is the @tool decorator used for?

It is a Python decorator used to define the metadata, description, and parameter schema of a function so that Claude agents can understand how and when to call it.

Can I use this skill to connect Claude to my own database?

Yes, this skill provides the patterns to create integration tools that allow Claude to interact with SQL or NoSQL databases securely.

What is an MCP server in this context?

An MCP (Model Context Protocol) server is a standardized way to host your custom tools, making them easily discoverable and usable by Claude agents.

Why should I use ClaudeSDKClient instead of query()?

Custom tools require the persistent session management provided by ClaudeSDKClient to handle the tool-calling loop effectively.

Tool Design Architect

Name: Tool Design Architect
Author: melodic-software

bymelodic-software

•

API Development

Empowers developers to design and implement custom, domain-specific tools for Claude agents using the @tool decorator and MCP servers.

The Tool Design skill provides a comprehensive framework for extending Claude's capabilities through custom tool creation. It guides users through the entire lifecycle of tool development—from defining purpose and interface design to implementing complex logic with robust error handling and security validation. By leveraging the Model Context Protocol (MCP) and the Agent SDK, this skill ensures that developers can build specialized, efficient, and reusable tools that transform Claude into a highly capable domain expert tailored to specific project requirements.

Key Features

01Comprehensive error handling and success response patterns

02Automated tool interface generation using the @tool decorator

03Step-by-step design process from conceptualization to deployment

04Seamless MCP server integration for agent extensibility

05Standardized parameter schema definition and validation

061 GitHub stars

Use Cases

01Creating custom MCP servers to connect Claude with internal enterprise APIs

02Building domain-specific agents for financial calculations or database queries

03Implementing secure, in-memory tools for data processing and transformation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add melodic-software/claude-code-plugins tool-design

For use in Claude.ai and ChatGPT

Download Skill