CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tool-discovery

Agent 工具数量变多、上下文被工具定义占满时使用——设计工具发现与渐进式披露机制、实现 discover_tools 元工具与两层语义路由、选择索引式/检索式/主动发现/Skills 方案、处理动态加载破坏 KV Cache 的问题、评估 token 成本与工具选择准确率时查阅。含渐进式加载五步流程、工具数量阈值与关键实验数据。

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, information-dense architecture reference with a clear core workflow and a genuine failure-recovery path. Its main weaknesses are repetition of the KV-cache guidance across three sections and a companion-code section whose referenced files are absent from the bundle, making those paths unusable.

Suggestions

State the KV-cache 'append to end, keep in position' rule once (in §4) and reference it from 核心原则 and 常见陷阱 instead of restating it; drop the reference-book analogy in §5.

Either ship the referenced `chapter4/active-tool-discovery/`, `chapter4/active-tool-selection/`, and `book/chapter4.md` files in the bundle (e.g. under references/ or scripts/) or remove the 配套代码/深度阅读 paths, since none of them resolve today.

Add concrete steps or a pointer for building and incrementally updating the embedding index used by the two-layer server→tool routing, which is currently named but never specified.

DimensionReasoningScore

Conciseness

The body is mostly efficient and fact-dense (46.9% token reduction, 3,857/40,258/540-550 token figures, 200-token proxy tool) and assumes Claude's competence, but the KV-cache 'append to end and keep in place' rule is repeated across 核心原则, §4, and 常见陷阱, and the reference-book analogy in §5 explains an idea Claude can grasp unaided. This fits 'mostly efficient but could be tightened' rather than the minor-trim level.

3 / 5

Actionability

Guidance is mostly concrete and executable in design terms: a literal `<tool_request>` example block, named baseline tools (web_search, code_interpreter, discover_tools), 3-5 candidate counts, precisely named API mechanisms (tool_search, defer_loading, tool_reference) with their constraints, and run commands (`python demo.py --offline`, `demo_comparison.py --offline`). The gaps — no how-to for the offline-built, incrementally-updated embedding index, and companion scripts not present in the bundle — keep it below fully executable.

4 / 5

Workflow Clarity

The core five-step progressive-loading flow is clearly sequenced (索引 → 声明需求 → 语义匹配 → 注入 schema → 调用) with an explicit no-match feedback loop ("明确返回'未找到',让 Agent 改写需求重试、用基础工具手工实现,或创造新工具"). It is not a 5 because supporting steps like embedding-index construction and incremental updating are asserted rather than specified, leaving minor checkpoint gaps.

4 / 5

Progressive Disclosure

Section organization is good and references are clearly signaled (dedicated 配套代码 and 深度阅读 sections), but the bundle contains no files at all — the referenced paths `chapter4/active-tool-discovery/`, `chapter4/active-tool-selection/`, and `book/chapter4.md` do not resolve, so the advertised commands cannot be followed. Per the guideline to score against the actual bundle structure, dangling one-level references and inline-carried detail place this at 'some structure but could be better organized'.

3 / 5

Total

14

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: specific, comprehensive action list with explicit use-when trigger clauses and a distinct niche. The only weakness is keyword coverage — it omits 'MCP' and other natural synonyms the body itself centers on.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities — "设计工具发现与渐进式披露机制、实现 discover_tools 元工具与两层语义路由、选择索引式/检索式/主动发现/Skills 方案、处理动态加载破坏 KV Cache 的问题、评估 token 成本与工具选择准确率" — giving comprehensive, specific coverage of the skill's actions in third-person voice.

5 / 5

Completeness

It explicitly answers both questions: what it provides ("设计…机制、实现…元工具与两层语义路由…含渐进式加载五步流程、工具数量阈值与关键实验数据") and when to use it via explicit trigger clauses ("Agent 工具数量变多、上下文被工具定义占满时使用" and "评估 token 成本与工具选择准确率时查阅"). This matches the anchor where both what and when are clearly answered with concrete trigger phrases, and the 'Use when' guideline is satisfied rather than capped.

5 / 5

Trigger Term Quality

Natural phrases users would say are present ("工具数量变多", "上下文被工具定义占满", "KV Cache", "token 成本", "工具选择准确率"), but a few common variations are missing — notably "MCP"/"MCP 服务器" (central to the topic), "Prompt Cache", and "工具太多/上百个工具". Good coverage, not comprehensive, so it sits at the level below the synonym-complete anchor.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — tool-discovery and progressive-disclosure architecture for large tool sets — with triggers (KV Cache breakage from dynamic loading, discover_tools, tool-count thresholds) unlikely to fire for unrelated skills. It is not the level-4 anchor because no meaningful overlap with a closely related skill is apparent from the text.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

bojieli/ai-agent-book

Path

skills/tool-discovery/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.