How does it improve debugging?

Every tool response follows a pattern that includes a unique request ID and structured error codes, making it simple to trace specific tool calls through your application logs.

What frameworks does this skill support?

The patterns are designed to be framework-agnostic but include specific implementations for LangChain and Pydantic, making them ideal for any AI agent that utilizes structured function calling.

How does this help with AI reliability?

By enforcing strict input validation and structured JSON error responses, it prevents malformed inputs from crashing your system and ensures the AI can understand and recover from tool failures.

Can I use this for async operations?

Yes, the skill includes specific design patterns for high-performance, I/O-bound asynchronous tool implementations using httpx and Python's async/await syntax.

Does it handle sensitive data in logs?

Yes, the pattern includes best practices for logging tool invocations that emphasize redacting PII (Personally Identifiable Information) to ensure security and compliance.

AI Tool Design Pattern

Name: AI Tool Design Pattern
Author: ricardoroche

byricardoroche

0•

Desarrollo de API

Enforces best practices for creating AI agent tools using Pydantic validation, robust error handling, and structured responses.

The AI Tool Design Pattern skill provides a comprehensive framework for developing high-quality tools for AI agents and function-calling workflows. It standardizes the creation of tools by enforcing Pydantic-based input schemas, detailed docstring documentation, and structured JSON outputs. By implementing these patterns, developers ensure their AI tools are resilient to malformed inputs, provide clear feedback to the LLM during errors, and maintain high observability through consistent logging and request tracking. This skill is essential for teams building production-grade agentic systems where reliability and security are paramount.

Características Principales

01Standardized error handling with structured JSON and unique request IDs

02Built-in patterns for both synchronous and high-performance async tools

03Pre-configured unit testing patterns for success and edge cases

040 GitHub stars

05Pydantic-based input validation with automatic schema generation

06Comprehensive logging templates with PII redaction safety

Casos de Uso

01Standardizing tool implementation across large Python development teams

02Developing custom LangChain tools for enterprise agentic workflows

03Creating secure and validated function-calling interfaces for Claude

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ricardoroche/ricardos-claude-code tool-design-pattern

For use in Claude.ai and ChatGPT

Características Principales

01Standardized error handling with structured JSON and unique request IDs

02Built-in patterns for both synchronous and high-performance async tools

03Pre-configured unit testing patterns for success and edge cases

040 GitHub stars

05Pydantic-based input validation with automatic schema generation

06Comprehensive logging templates with PII redaction safety

Casos de Uso

01Standardizing tool implementation across large Python development teams

02Developing custom LangChain tools for enterprise agentic workflows

03Creating secure and validated function-calling interfaces for Claude

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ricardoroche/ricardos-claude-code tool-design-pattern

For use in Claude.ai and ChatGPT