CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-search-best-practices

按问题与证据缺口选择记忆检索范围(8 类题型参考)。 Use when: 任务是 "哪些地方提过 X" / "X 的来源 / source map" / "有没有提过 Y / absence check" / "上次到现在变了什么 / delta" / 冷启动 onboard 复杂主题 / 任何召回任务搜了一刀觉得不够。 Not for: 只是选哪个入口走第一刀(用 memory-navigation)/ 已知精确 anchor 单 Read(直接 Read)/ 代码符号查(Grep/LSP)/ 新功能开发(不是 recall 任务)。 Output: 单一 owner 汇总原始证据、实际覆盖与未验证边界,一次交付。 GOTCHA: memory-navigation 选择入口;本 skill 处理证据缺口与覆盖边界,不按模型家族或固定轮次决定停止。

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

75%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.

The body is a dense, well-organized decision guide built around a per-question-type table of concrete tool paths with explicit convergence criteria and a misjudgment/remedy table. It is consistently just short of excellent across dimensions: minor redundancy, no copy-paste example calls, an implicit rather than explicitly numbered global sequence, and case lore inlined instead of split into reference files.

Suggestions

Move case-specific lore (复杂 coverage 的本地经验 expansion terms, F256 Related-directions behavior) into a references/ file and keep SKILL.md to the question-type table, convergence rules, and misjudgment table.

Add one full example invocation per major tool (e.g., a concrete search_evidence query with options and the fields it returns) so the listed paths become copy-paste ready.

Trim redundancy: the second sentence of 价值门禁 repeats the frontmatter Not-for clause, and the 按证据缺口判断 prose restates the 收敛依据 column of the 8-type table.

DimensionReasoningScore

Conciseness

The body is dense local guidance that assumes Claude's competence ("graph_resolve(anchor, depth=1)", "truncated、scanCapped 或 degraded 时,保留这一覆盖限制") with no generic concept explanations, but has minor trimmable redundancy: "已知精确 anchor、代码符号查询或新功能实现不需要套用整套检索" duplicates the frontmatter Not-for, and the 按证据缺口判断 prose overlaps the table's 收敛依据 column. This fits 'efficient; minor instances of over-explanation that could be trimmed' — not 5 because of that redundancy, not 3 because there is no padded or already-known-concept content.

4 / 5

Actionability

The 8-type table gives concrete tool paths per question ("精确 anchor 用 graph_resolve;模糊概念用 search_evidence(scope=docs, mode=hybrid)") and the 常见误判 table pairs each mistake with a concrete remedy. It falls short of 'fully executable; copy-paste ready' because no complete example invocation (query string plus options) is shown, but it is well above the pseudocode/vague anchor since real tools are named with parameters.

4 / 5

Workflow Clarity

Each question type pairs a path with an explicit convergence checkpoint ("原文足以回答当前问题", "主要相关来源已覆盖…报告实际边界") and the 常见误判 table supplies error-recovery handling, so checkpoints are present rather than implicit. It does not reach 5 because the global order of operations (classify → search → converge → deliver) is never laid out as an explicit sequence, and it is above 3 because stopping and verification criteria are stated concretely. This is a read-only recall skill, so the destructive/batch validation cap does not apply.

4 / 5

Progressive Disclosure

A well-sectioned single file (~74 lines) with one-level-deep, clearly signaled external references in a dedicated section ("docs/features/F200-memory-recall-eval.md", "docs/features/F256-memory-search-strategy-evolution.md", "../.cat-cafe-shared-refs/memory-routing-partial.md"); no references/, scripts/, or assets/ bundle directories exist to verify beyond the body. Minor gap: case-specific lore (AUDHD expansion terms, F256 Related-directions quirks) is inlined where a references/ split would keep the core leaner — good structure with minor organization gaps rather than the fully 'appropriately split' top anchor, and clearly above the buried-reference/inlined-bulk anchors below.

4 / 5

Total

16

/

20

Passed

Description

90%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.

The description explicitly states what the skill does, when to use it via concrete bilingual trigger phrases, and when not to use it, giving it excellent trigger quality, completeness, and distinctiveness. Its only weakness is specificity: the 'what' stays at the meta level of scope selection and single-owner consolidation rather than enumerating concrete actions.

DimensionReasoningScore

Specificity

"按问题与证据缺口选择记忆检索范围(8 类题型参考)" and the Output line "单一 owner 汇总原始证据、实际覆盖与未验证边界,一次交付" name the domain plus one or two meta-level actions, but there is no fuller inventory of concrete operations — matching the '1-2 concrete actions, not comprehensive' anchor. Not 2 because the domain and actions are named concretely rather than generically; not 4 because the stated actions are process-level (choose scope, consolidate, deliver) rather than several specific capabilities.

3 / 5

Completeness

It explicitly answers both questions: what ("按问题与证据缺口选择记忆检索范围" with an Output spec of "汇总原始证据、实际覆盖与未验证边界,一次交付") and when (an explicit "Use when:" clause with concrete trigger phrases, plus a "Not for:" exclusion list). This matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'.

5 / 5

Trigger Term Quality

The Use-when clause packs natural user phrases with synonyms in two languages: "哪些地方提过 X", "X 的来源 / source map", "有没有提过 Y / absence check", "上次到现在变了什么 / delta", "冷启动 onboard 复杂主题", plus "任何召回任务搜了一刀觉得不够" as a catch-all. This is comprehensive natural-term coverage including CN/EN synonym variants, matching the top anchor rather than the 'a few natural terms missing' anchor below it.

5 / 5

Distinctiveness Conflict Risk

"Not for: ...(用 memory-navigation)/ 已知精确 anchor 单 Read(直接 Read)/ 代码符号查(Grep/LSP)" and "GOTCHA: memory-navigation 选择入口;本 skill 处理证据缺口与覆盖边界" carve out a clear niche and actively route overlapping triggers to other tools, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

zts212653/clowder-ai

Path

cat-cafe-skills/memory-search-best-practices/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.