tool-function-schema-designer — скилл для Claude Code
Скилл tool-function-schema-designer помогает описать инструменты для LLM так, чтобы модель вызывала их с валидными аргументами: JSON-схема, типы, проверка через zod и примеры вызовов.
MIT 258 установок ★ 64 обновлён 2026-01-12
npx skills add patricio0312rev/skills --skill tool-function-schema-designer -a claude-codeЧто делает tool-function-schema-designer
Скилл ведёт через проектирование инструмента для LLM: сначала JSON-схема функции с описанием, enum для категорий и границами значений, потом TypeScript-интерфейс под те же параметры. В описании схемы он требует указать, когда инструмент вызывать: от этой фразы зависит, дёрнет ли его модель вообще.
Дальше начинается рантайм. Аргументы от модели проходят через zod-схему до вызова реализации, а реестр инструментов хранит для каждого схему, реализацию и валидатор. Ошибки разложены по кодам — VALIDATION_ERROR и EXECUTION_ERROR — чтобы модель увидела, что именно не так с параметрами, и повторила вызов.
Схема без проверки означает доверие к строке, которую вернула модель: без zod-валидатора max_results прилетит строкой или выйдет за пределы 1–10 и уедет в хранилище как есть. Чек-лист на выходе перечисляет JSON-схему, интерфейс, валидатор, функцию-реализацию, обработку ошибок, примеры вызовов и запись в реестре.
Какие задачи решает
- описать инструмент для LLM так, чтобы модель не путала аргументы
- задать
enumи границы значений в JSON-схеме функции - проверить параметры от модели до вызова реализации
- собрать реестр инструментов с валидатором и обработчиком ошибок
- показать модели примеры успешных вызовов
Примеры запросов агенту
- Спроектируй схему функции
search_documentationдля tool calling: параметры,enumкатегорий, границыmax_results. - Добавь к этой схеме TypeScript-интерфейс и валидацию через
zod, плюс примеры вызовов. - Собери реестр инструментов с обработкой ошибок: неизвестный инструмент и невалидные параметры.
Как установить tool-function-schema-designer
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill tool-function-schema-designer -a claude-code2Вручную: положить файлы
~/.claude/skills/tool-function-schema-designer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tool-function-schema-designer/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill tool-function-schema-designer -a codex2Вручную: положить файлы
.agents/skills/tool-function-schema-designer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill tool-function-schema-designer -a cursor2Вручную: положить файлы
.cursor/skills/tool-function-schema-designer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install patricio0312rev/skills ai-engineering/tool-function-schema-designer/SKILL.md2Вручную: положить файлы
.github/skills/tool-function-schema-designer/SKILL.md1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill tool-function-schema-designer -a gemini-cli2Командой платформы
gemini skills install https://github.com/patricio0312rev/skills --path ai-engineering/tool-function-schema-designerВручную: положить файлы
.devin/skills/tool-function-schema-designer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill tool-function-schema-designer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tool-function-schema-designer
Как установить tool-function-schema-designer в Claude Code?
Выполните npx skills add patricio0312rev/skills --skill tool-function-schema-designer -a claude-code. Скилл окажется в ~/.claude/skills/tool-function-schema-designer/SKILL.md.
Что делает tool-function-schema-designer?
Проектирует схему функции для tool calling: JSON-схему параметров, TypeScript-интерфейс, валидатор на zod, обработку ошибок и примеры вызовов. По такой схеме модель понимает, когда и с какими аргументами дёргать инструмент.
Что нужно, чтобы валидация из скилла заработала?
Библиотека zod: схемы в примерах импортируют z из неё, а ошибки проверки ловятся как z.ZodError и превращаются в ответ с кодом VALIDATION_ERROR.
Исходный текст
SKILL.md · MIT
---
name: tool-function-schema-designer
description: Designs robust function/tool calling schemas for LLMs with JSON schemas, validation strategies, typed interfaces, and example calls. Use when implementing "function calling", "tool use", "LLM tools", or "agent actions".
---
# Tool/Function Schema Designer
Design robust tool schemas that LLMs can reliably invoke.
## Function Schema Format
```typescript
// OpenAI function calling format
const searchDocsTool = {
type: "function",
function: {
name: "search_documentation",
description:
"Search through product documentation using semantic search. Use this when the user asks about features, how-tos, or troubleshooting.",
parameters: {
type: "object",
properties: {
query: {
type: "string",
description: "The search query, phrased as a question or keywords",
},
filters: {
type: "object",
properties: {
category: {
type: "string",
enum: ["api", "guides", "tutorials", "troubleshooting"],
description: "Filter by documentation category",
},
version: {
type: "string",
description: "Filter by product version (e.g., 'v2.0')",
},
},
},
max_results: {
type: "integer",
minimum: 1,
maximum: 10,
default: 5,
description: "Maximum number of results to return",
},
},
required: ["query"],
},
},
};
```
## Typed Interfaces
```typescript
// TypeScript types matching schema
interface SearchDocsParams {
query: string;
filters?: {
category?: "api" | "guides" | "tutorials" | "troubleshooting";
version?: string;
};
max_results?: number;
}
// Implementation
async function search_documentation(
params: SearchDocsParams
): Promise<SearchResult[]> {
const { query, filters = {}, max_results = 5 } = params;
// Implementation
return await vectorStore.search(query, {
filter: filters,
limit: max_results,
});
}
```
## Validation Strategy
```typescript
import { z } from "zod";
// Zod schema for runtime validation
const searchDocsSchema = z.object({
query: z.string().min(1, "Query cannot be empty"),
filters: z
.object({
category: z
.enum(["api", "guides", "tutorials", "troubleshooting"])
.optional(),
version: z.string().optional(),
})
.optional(),
max_results: z.number().int().min(1).max(10).default(5),
});
// Validate before execution
function validateAndExecute(toolName: string, params: unknown) {
const validated = searchDocsSchema.parse(params);
return search_documentation(validated);
}
```
## Tool Registry
```typescript
export const TOOLS = {
search_documentation: {
schema: searchDocsTool,
implementation: search_documentation,
validator: searchDocsSchema,
},
create_ticket: {
schema: createTicketTool,
implementation: create_ticket,
validator: createTicketSchema,
},
// ... more tools
};
// Execute tool safely
async function executeTool(name: string, params: unknown) {
const tool = TOOLS[name];
if (!tool) throw new Error(`Unknown tool: ${name}`);
const validated = tool.validator.parse(params);
return tool.implementation(validated);
}
```
## Example Calls
```typescript
// Example 1: Simple search
{
"name": "search_documentation",
"parameters": {
"query": "How do I authenticate API requests?"
}
}
// Example 2: With filters
{
"name": "search_documentation",
"parameters": {
"query": "rate limiting",
"filters": {
"category": "api",
"version": "v2.0"
},
"max_results": 3
}
}
```
## Error Handling
```typescript
interface ToolResult {
success: boolean;
data?: any;
error?: {
code: string;
message: string;
};
}
async function safeExecuteTool(
name: string,
params: unknown
): Promise<ToolResult> {
try {
const data = await executeTool(name, params);
return { success: true, data };
} catch (error) {
if (error instanceof z.ZodError) {
return {
success: false,
error: {
code: "VALIDATION_ERROR",
message: `Invalid parameters: ${error.message}`,
},
};
}
return {
success: false,
error: {
code: "EXECUTION_ERROR",
message: error.message,
},
};
}
}
```
## Best Practices
1. **Clear descriptions**: Explain when to use the tool
2. **Specific types**: Use enums, ranges, patterns
3. **Sensible defaults**: Reduce required parameters
4. **Validate rigorously**: Don't trust LLM output
5. **Error messages**: Help LLM correct mistakes
6. **Example calls**: Show success cases
7. **Type safety**: TypeScript interfaces
## Output Checklist
- [ ] JSON schema defined
- [ ] TypeScript interface
- [ ] Validation with Zod
- [ ] Implementation function
- [ ] Error handling
- [ ] Example calls (3+)
- [ ] Tool registry entry
- [ ] Documentation
© patricio0312rev · MIT · patricio0312rev/skills