К основному содержанию
скилл CX Codex

tool-function-schema-designer — скилл для Claude Code

Скилл tool-function-schema-designer помогает описать инструменты для LLM так, чтобы модель вызывала их с валидными аргументами: JSON-схема, типы, проверка через zod и примеры вызовов.

MIT 258 установок ★ 64 обновлён 2026-01-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add patricio0312rev/skills --skill tool-function-schema-designer -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/tool-function-schema-designer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tool-function-schema-designer/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
langchain4j-tool-function-calling-patterns giuseppe-trisciuoglio Скилл langchain4j-tool-function-calling-patterns подсказывает агенту, как описывать Java-методы через @Tool, регистрировать их в AiServices и обрабатывать ошибки вызова. CX Codex +1 3 900установок llm-app-development travisjneuman Скилл llm-app-development для Claude Code помогает проектировать RAG-пайплайны, агентов и вызовы инструментов с валидацией через Zod. Включается при сборке чат-ботов, баз знаний и генеративных сервисов. CX Codex +1 139установок tools launchdarkly Скилл tools для Claude Code и Codex помогает создавать определения инструментов и привязывать их к вариациям конфигов LaunchDarkly. Пошагово ведёт через вызовы удалённого MCP-сервера. CX Codex +1 1 900установок agent-protocol borghei Скилл agent-protocol для Claude Code проектирует схемы инструментов и форматы обмена данными между агентами. Помогает связывать сервисы через MCP, Google A2A и OpenAI Function Calling. CX Codex +1 104установок zod-schema-validation Mindrally Скилл zod-schema-validation задаёт правила валидации данных через Zod и вывода типов TypeScript на границах системы: в API, формах и внешних ответах. Помогает писать схемы без лишнего дублирования. CX Codex +1 1 200установок zod-validation oakoss Скилл zod-validation учит агента синтаксису и правилам Zod v4 в TypeScript. Пригодится при составлении схем данных, валидации форм, парсинге API и конвертации схем в JSON Schema. CX Codex +1 222установок

Из того же набора148

Весь набор →
api-contract-normalizer Скилл api-contract-normalizer для Claude Code приводит ответы API к общим правилам формата, ошибок, пагинации и версий. Унифицирует ответы разных эндпоинтов. CX Codex +1 260установок vscode-rest-client-generator Скилл vscode-rest-client-generator для Claude Code находит маршруты в Express, Next.js и Fastify и генерирует .http-файлы для VS Code REST Client. Файлы содержат запросы для ручного тестирования API в редакторе без Postman. CX Codex +1 259установок embedding-pipeline-builder Скилл embedding-pipeline-builder для Claude Code собирает пайплайны эмбеддингов документов: загрузку, очистку, чанкинг, индексацию и настройку поиска. Поддерживает RAG и семантическую индексацию. CX Codex +1 259установок llm-debugger Скилл llm-debugger находит причины сбоев в ответах нейросетей, правит системные промпты и генерирует регрессионные тесты для фиксации ошибок. CX Codex +1 259установок test-reporting-triage-skill Скилл test-reporting-triage-skill для Claude Code группирует ошибки тестов по категориям, предлагает ответственные команды и варианты исправления. Разбирает результаты прогона тестов. CX Codex +1 257установок mocking-assistant Скилл mocking-assistant помогает создавать моки для API, сервисов и UI через MSW и Vitest: от фикстур данных до перехвата системного времени в тестах. CX Codex +1 256установок service-layer-extractor Скилл service-layer-extractor выносит бизнес-логику из контроллеров в сервисы и репозитории. Помогает навести порядок в раздутых роутах и подготовить код к юнит-тестам. CX Codex +1 255установок rag-pipeline-builder Скилл rag-pipeline-builder проектирует RAG-пайплайн для ассистента по документам: чанкинг, метаданные, гибридный поиск, реранкинг и план оценки качества. CX Codex +1 251установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой