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).
Install
npx skills add j4flmao/agent-skills --skill tool-calling-principlesgit 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-principlesPersonal 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.Details
- Skill name
tool-calling-principles- Repository
- j4flmao/agent-skills
- 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
45j4flmao/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).
AI Agent Architectures
45j4flmao/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 Agent Core Loop
45j4flmao/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).
Triton Kernels
45j4flmao/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).
Tensorrt Optimization
45j4flmao/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).
Moufa Xingyun Avatar
11lewislulu/moufa-xingyun-avatar
给任意 Agent 接上一个魔珐星云(Xmov)实时 3D 数字人前端——网页里 new 一个数字人,把 Agent 的文字输出喂给 speak(),它就实时说话、配口型、做动作。当用户想"给 Agent / 聊天机器人 / LLM 加一个会说话的虚拟形象、数字人、虚拟主播、3D avatar 前台",或要接入魔珐星云 / 星云 / Xmov / XmovAvatar SDK 时使用本技能。
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.