tool-calling-tutor SKILL.md skillA
tool-calling-tutor from wenyuchiou/awesome-agentic-ai-zh is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add wenyuchiou/awesome-agentic-ai-zh/tool-calling-tutor@git:20260828.39e461dPins git:20260828.39e461d in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- wenyuchiou/awesome-agentic-ai-zh
- Path
examples/stage-5/tool-calling-tutor/SKILL.md- Versions recorded
- 3
- Latest version
- git:20260828.39e461d, committed Aug 28, 2026
- First version recorded
- May 13, 2026
- Size
- 7,965 bytes
- Repository stars
- 8,548
- License
- MIT
Use when a tool-calling agent does not call a tool, sends wrong arguments, loops without stopping, or needs a function schema. Guides a four-branch diagnosis and five-step schema repair. Do not use for framework-specific, MCP-server, or production-observability questions.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Tool Calling Tutor
You are now in the **tool-calling debugging** context. The user is building an agent that calls functions / tools, and something isn't working. Your job is to walk them through diagnosis + fix, not to write code for them.
## Step 1 — Triage（first thing you do）
When the user mentions tool calling problems, first infer the route from an explicit symptom and briefly confirm it. Ask one multiple-choice question only when the symptom is not explicit:
1. **(a) LLM 不呼叫我的 tool** — 模型直接用自然語言回答、完全沒觸發 tool_calls
2. **(b) Tool 被呼叫、但參數錯** — 呼叫對 tool，但 `arguments` 不對（型別錯、缺欄位、值不合理）
3. **(c) ReAct loop 跑不停 / 漏步** — 多步 loop 無限循環，或者中間漏一個 tool 沒呼叫
4. **(d) 我從零開始、還沒寫 schema** — 用戶要新做一個 tool、想知道 schema 怎麼設計
明確的症狀不用重問；確認你推定的 route 後直接繼續。每個 branch 走的 reference 不同。
## Step 2 — Branch by symptom
### (a) LLM 不呼叫 tool → 看 description 與工具邊界
先檢查這 3 項：
1. **`description` 太籠統**：寫的是「處理資料 / Convert a value / Search things」這種給人讀的 docstring，LLM 看不到「這個 tool 解什麼具體問題」。看 [debug-flowchart.md](${CLAUDE_SKILL_DIR}/references/debug-flowchart.md) Section A。
2. **多 tool 邊界互相重疊**：兩個 tool 的 description 都能套到 user query、LLM 選不出來、乾脆都不選。
…Read the whole file at its exact version.
How to install
mdr add wenyuchiou/awesome-agentic-ai-zh/tool-calling-tutor@sha256:a191709903cde046The line at the top of this page pins the label git:20260828.39e461d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_coguedr2lm267mwc)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between May 13, 2026 and Aug 28, 2026, about one every 54 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260828.39e461d latest | 2026-08-28 | 39e461d | 7,965 B | A | view · diff |
| git:20260514.29eb774 | 2026-05-14 | 29eb774 | 7,677 B | A | view · diff |
| git:20260513.3584669 | 2026-05-13 | 3584669 | 7,683 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (7965 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
wenyuchiou/awesome-agentic-ai-zh · 8,548 stars · license MIT · pushed 2026-11-02 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_coguedr2lm267mwc GET https://markdownregistry.com/api/v1/resolve?ref=wenyuchiou/awesome-agentic-ai-zh/tool-calling-tutor GET https://markdownregistry.com/api/v1/blob/a191709903cde046768f9e4943554075f250a43274bb12e27d84d4882d6097f4
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.