CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kb-retriever

面向本地知识库目录的检索和问答助手。核心流程:(1)分层索引导航 (2)遇到PDF/Excel时必须先读取references学习处理方法 (3)处理文件后再检索。按文件类型组合使用 grep、Read、pdfplumber、pandas 进行渐进式检索,避免整文件加载。用户问题涉及"从知识库目录回答问题/检索信息/查资料"时使用。

Quality

85%

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

73%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-sequenced, actionable retrieval workflow with genuine validation checkpoints and feedback loops, supported by clearly signaled one-level-deep references. The main costs are token redundancy from repeating the read-references-first mandate across six sections, and an orphaned scripts/convert_pdf_to_images.py that the overview never points to.

Suggestions

State the 'must read references before handling PDF/Excel' mandate once (e.g. in the 关键原则 checklist) and delete the repeats in 禁止行为, 总体流程 step 3, the PDF/Excel workflow headers, and 与其他工具的协同, cutting the repeated "注意这个目录位于 Skills 目录下" caveat with them.

Merge or remove the 与其他工具的协同 section, since its PDF/Excel and tool-usage content restates what the per-file-type strategies already specify.

Add a pointer to scripts/convert_pdf_to_images.py (e.g. in the PDF strategy section) so every bundle file is reachable from the SKILL.md overview.

DimensionReasoningScore

Conciseness

The body is procedural and does not explain concepts Claude already knows, but it is noticeably redundant: the mandate to read references before handling PDF/Excel appears ~6 times (checklist, 禁止行为, step 3, PDF workflow, Excel workflow, 与其他工具的协同), the caveat "注意这个目录位于 Skills 目录下" repeats 4 times, and the 与其他工具的协同 section largely restates the per-file-type workflows. Not 2: there is no pedagogical padding and every section is on-task; not 4: the duplication goes beyond minor trimming and could be cut substantially.

3 / 5

Actionability

Concrete, executable commands and parameters appear throughout: `test -d knowledge`, `pdftotext input.pdf output.txt` (with an explicit reason not to use stdout), Glob patterns like `pattern="**/data_structure.md"`, `path="knowledge"`, Read with `limit=300`, pandas `nrows` 10-50, and `df[df['column'] == value]`, with implementation detail correctly deferred to the reference files. Not 5: a few instructions remain directional rather than executable (e.g. "提取命中附近范围的上下文(上下数十行或相邻几页)" gives no concrete command); not 3: the given commands are real and specific, not pseudocode.

4 / 5

Workflow Clarity

The 6-step 总体流程 is clearly sequenced with explicit checkpoints: directory existence must be validated via `test -d` before any Glob, the mandatory pre-PDF/Excel checklist gates processing, and the 多轮迭代检索机制 defines a feedback loop with a 5-attempt cap, per-round keyword regeneration, termination conditions, and insufficient-information handling including asking the user when the root directory is missing. Not 4: validation steps, recovery loops, and a checklist are all explicitly present, matching the anchor-5 example.

5 / 5

Progressive Disclosure

The three reference files (pdf_reading.md, excel_reading.md, excel_analysis.md) are real, one level deep, and clearly signaled via markdown links plus explicit 'read before processing' triggers. Not 5: scripts/convert_pdf_to_images.py is referenced nowhere in SKILL.md or the references, leaving an orphaned bundle file undiscoverable from the overview; not 3: structure, placement, and signaling are otherwise good with no inline content that belongs in a separate file.

4 / 5

Total

16

/

20

Passed

Description

88%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 dense, concrete description that explicitly covers both what the skill does and when to use it, with natural trigger phrases and named tools. Minor gaps in synonym coverage keep trigger quality and distinctiveness at 4 rather than 5.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "分层索引导航", "遇到PDF/Excel时必须先读取references学习处理方法", "按文件类型组合使用 grep、Read、pdfplumber、pandas 进行渐进式检索,避免整文件加载" — covering navigation, learning, processing, and retrieval with named tools. Not 4: coverage of the skill's capabilities is comprehensive with no apparent gaps, matching the anchor for multiple specific concrete actions.

5 / 5

Completeness

Both parts are explicit: the 'what' is the retrieval/Q&A pipeline with its three-step core process, and the 'when' is a concrete trigger clause — "用户问题涉及'从知识库目录回答问题/检索信息/查资料'时使用". Not 4: the 'when' is not merely present but explicit with concrete trigger phrases, matching the anchor-5 example.

5 / 5

Trigger Term Quality

Natural trigger phrases are present — "从知识库目录回答问题/检索信息/查资料" plus PDF/Excel mentions — which a user would plausibly say. Not 5: common variations and synonyms are missing (e.g. "搜索"/"查询", standalone "知识库", English equivalents, file extensions like .md/.xlsx); not 3: coverage already includes several distinct natural phrasings.

4 / 5

Distinctiveness Conflict Risk

Anchored to a clear niche — "面向本地知识库目录的检索和问答助手" with local-directory triggers — making it mostly distinct from generic document or PDF skills. Not 5: "检索信息/查资料" could still fire for general search requests with no knowledge base present; not 3: overlap risk is minor, not 'somewhat specific'.

4 / 5

Total

18

/

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

ConardLi/garden-skills

Path

skills/kb-retriever/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.