Skip to content
Get packs

Tool Calling Tutor

Diagnoses and fixes AI agent tool-calling failures (missed calls, wrong arguments, loops) with guided steps

Source Download skill
Repository
WenyuChiou/awesome-agentic-ai-zh
Stars
8,405
Licence
MIT
Files
15 files

What it does

When an AI agent that uses functions or tools is not calling a tool, sends wrong arguments, or loops forever, this skill makes the agent walk you through a structured diagnosis and a five-step schema repair instead of guessing. It asks which symptom you have, checks the tool descriptions, parameter types, required fields and control flow, and points to reference notes and example starters. It is designed to coach you rather than write the whole program for you.

Great for

  • Developers building a tool-calling or ReAct-style agent who see the model ignore their tools
  • Learners who want to understand how function schemas should be designed
  • Teams comparing Anthropic and OpenAI-compatible tool-calling formats

Skip it if

  • Framework-specific questions (LangChain, LangGraph, CrewAI, Pydantic AI), which the skill itself says to route elsewhere
  • Production monitoring, observability or cost tracking, which is out of scope
  • Non-developers without an agent project to debug, since the guidance assumes code and API responses

Try asking

  • “My agent answers in plain text and never calls my get_weather tool. Help me debug it.”
  • “The model passes unit as 'C' and 'Celsius' inconsistently. How should I redesign the parameter schema?”
  • “My ReAct loop keeps calling the same tool forever. Walk me through the likely causes.”
  • “I'm starting a new tool from scratch. Guide me through the five-step schema design.”
Step-by-step guide: how to use Tool Calling TutorInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the MIT licence and an attribution note.

    tool-calling-tutor.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip tool-calling-tutor.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip tool-calling-tutor.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • State your exact symptom (no call, wrong arguments, or loop) so the skill can skip its triage question.
  • Test with a small fixed fixture and mock responses before connecting a real model, as the skill recommends.
  • Use the linked starter templates to write your own TOOLS_SPEC rather than asking for a complete program.

What's inside

  • evals/check_evals.py
  • evals/evals.json
  • README.en.md
  • README.md
  • README.zh-Hans.md
  • references/debug-flowchart.en.md
  • references/debug-flowchart.md
  • references/debug-flowchart.zh-Hans.md
  • references/schema-evolution.en.md
  • references/schema-evolution.md
  • references/schema-evolution.zh-Hans.md
  • references/sdk-diff.en.md
  • references/sdk-diff.md
  • references/sdk-diff.zh-Hans.md
  • SKILL.md

Redistributed unmodified from WenyuChiou/awesome-agentic-ai-zh under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.