---
name: "openai-function-calling-schemas"
description: "Generate strict, type-safe JSON function calling schemas for reliable tool execution."
metadata:
  author: "OpenAI"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "write openai tool definition"
  - "convert pydantic to tool schema"
  - "use strict function calling"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# OpenAI Function Calling Strict Schema Generator

Structures tool calling definitions: type: 'function', strict: true, required parameter arrays, nested object schemas, and Pydantic-to-OpenAI function schema converters.

## When to Invoke
Invoke this skill whenever you need to:
- write openai tool definition
- convert pydantic to tool schema
- use strict function calling

## Execution SOP & Rules
1. Always set strict: true on function schemas to guarantee zero hallucinated arguments.
2. Provide clear, descriptive docstrings on every property explaining expected format and units.
3. Declare all properties inside the required array when strict mode is enabled.
4. Validate parsed arguments against local Pydantic or Zod models before execution.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.