Tool Calling Principles

Use when the user asks about tool calling, function calling, tool schemas, tool_use / tool_result, strict structured outputs, an agent picking the wrong tool or tool error handling. Produces JSON Schema tool definitions, validated handlers with teaching errors, idempotency and a permission matrix. Not for the agent loop (use ai-agent-core-loop) or REST API design (use backend-api-design).

45 stars 6 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add j4flmao/agent-skills --skill tool-calling-principles
Manual install
git clone --depth 1 https://github.com/j4flmao/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/ai/ai-agents/tool-calling-principles ~/.claude/skills/tool-calling-principles

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Tool-Calling Principles

## Purpose
Tools are the agent's only way to read or change the world, and the model chooses and fills them using nothing but names, descriptions, and schemas. Good tools are few, coarse-grained, strictly typed, safe to retry, and return compact results with actionable errors. This skill gives the rules and templates for designing them.

## Agent Protocol

### Trigger
"tool calling", "function calling", "tool schema", "tool description", "wrong tool selected", "tool errors", "strict mode", "structured output".

### Input Context
- The operations the agent needs and the underlying APIs.
- Side effects of each operation (read, reversible write, irreversible).
- Provider (Anthropic, OpenAI, other) and whether strict schema mode is available.
- Observed failure transcripts if debugging.

### Output Artifact
Tool definitions (JSON Schema), handler skeletons with validation and error contract, permission matrix.

### Response Format
```
Tool: {verb_noun}  Side effect: {read|write-reversible|write-irreversible}  Approval: {none|human}
Description: {what, when to use, when NOT to use, output shape, limits}
Schema: {required fields, enums, formats}
Errors: {code: hint}
Idempotency: {key or natural}
```

### Completion Criteria
- [ ] Small, cohesive tool set; overlapping tools merged or removed.
- [ ] Descriptions say when to use and when not to use.
- [ ] Schemas use enums/formats/required fields; strict mode on where supported.
Read the full skill on GitHub

Details

Skill name
tool-calling-principles
Path
skills/ai/ai-agents/tool-calling-principles/SKILL.md
License
MIT
Repo updated
17 November 2026

FAQ

What does the Tool Calling Principles skill do?

Use when the user asks about tool calling, function calling, tool schemas, tool_use / tool_result, strict structured outputs, an agent picking the wrong tool or tool error handling. Produces JSON Schema tool definitions, validated handlers with teaching errors, idempotency and a permission matrix. Not for the agent loop (use ai-agent-core-loop) or REST API design (use backend-api-design).

How do I install the Tool Calling Principles skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add j4flmao/agent-skills --skill tool-calling-principles. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Tool Calling Principles popular?

It lives in j4flmao/agent-skills, which has 45 GitHub stars and 6 forks.

Related skills

Agent Observability

45

j4flmao/agent-skills

Use when the user asks about agent observability, tracing agent reasoning, debugging an agent loop, OpenTelemetry GenAI spans for LLM calls, LLM cost tracking per agent, agent audit logs or hallucination/eval monitoring in production. Produces instrumentation config, trace schema, dashboards, alerts and cost attribution. Not for generic service tracing without LLMs (use devops-opentelemetry).

DevOps & Cloud

AI Agent Architectures

45

j4flmao/agent-skills

Use when the user asks to build an AI agent, design an agent that calls tools and keeps memory, write an agent system prompt or pick an agent framework (Claude Agent SDK, OpenAI Agents SDK, LangGraph). Produces an architecture brief covering loop, tools, memory, guardrails and evals, routing depth to child skills. Not for workflow patterns (use ai-agentic-workflows).

AI, LLMs & Agents

AI Agent Core Loop

45

j4flmao/agent-skills

Use when the user asks about the agent loop, ReAct vs plan-and-solve, re-planning, Reflexion, an agent stuck in a loop, max iterations or termination conditions. Produces a loop spec or patch with state, success predicate, caps and no-progress detection. Not for overall agent design (use ai-agent-architectures) or tool schemas (use tool-calling-principles).

AI, LLMs & Agents

Triton Kernels

45

j4flmao/agent-skills

Use when the user asks about OpenAI Triton kernels, @triton.jit, tl.load, tl.dot, triton.autotune, fused kernels in Python or torch.compile Inductor kernels. Produces a kernel, PyTorch wrapper, correctness test and do_bench benchmark. Not for Triton Inference Server (use ml-model-serving) or CUDA C++ (use cuda-programming).

AI, LLMs & Agents

Tensorrt Optimization

45

j4flmao/agent-skills

Use when the user asks about TensorRT, trtexec, ONNX to TensorRT engines, optimization profiles for dynamic shapes, FP8/INT8 engines, Polygraphy or TensorRT-LLM / trtllm-serve. Produces build commands, precision plan and benchmark plan. Not for choosing GPTQ/AWQ in depth (use extreme-quantization-mastery) or serving platforms (use ml-model-serving).

AI, LLMs & Agents

Moufa Xingyun Avatar

11

lewislulu/moufa-xingyun-avatar

给任意 Agent 接上一个魔珐星云(Xmov)实时 3D 数字人前端——网页里 new 一个数字人,把 Agent 的文字输出喂给 speak(),它就实时说话、配口型、做动作。当用户想"给 Agent / 聊天机器人 / LLM 加一个会说话的虚拟形象、数字人、虚拟主播、3D avatar 前台",或要接入魔珐星云 / 星云 / Xmov / XmovAvatar SDK 时使用本技能。

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.