CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

find-session

按对话标题或正文关键词快速定位 DSH 历史会话并读取内容/统计;用于“根据对话名跟踪对话”“查找之前的会话”“查看某会话 token 消耗”等请求。

Quality

95%

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

The canonical home for this skill is find-session in ooooooooooooooooooop/agent-tools

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 an exemplary short skill: fully executable commands for every workflow, explicit failure-reporting rules, a verification/regression section, and a single real, clearly-signaled script reference. The only improvement space is trimming the slight redundancy between the opening, the path-hint blockquote, and the closing section.

DimensionReasoningScore

Conciseness

The body is lean — concrete commands, no concept explanations Claude already knows, everything earns its place — but the path-hint blockquote and the closing "脚本是唯一入口" section partially repeat the opening instruction, minor trims possible. Not 5 due to that slight redundancy; not 3 because there is no unnecessary explanation or padding beyond it.

4 / 5

Actionability

Every workflow is given as a copy-paste-ready command with real flags (--content, --grep, --full, --id, --stats, --project, --since/--until, --sort, --max) covering the common cases, plus fixed paths for the index and session files. Not 4 because the commands are complete and executable as written with no gaps.

5 / 5

Workflow Clarity

The flow is clearly organized by use case (fast title search → slow body search → by-id → filters), with a 验证 section giving per-use checks and post-change regression steps, and explicit failure reporting ("搜索无匹配时报告'无匹配会话',不以空结果冒充成功;会话文件缺失时给出明确提示"). Operations are read-only, so the destructive-cap does not apply. Not 4 because validation and failure-feedback loops are explicitly present, not implicit.

5 / 5

Progressive Disclosure

A short, well-sectioned overview with exactly one bundle file (scripts/find_session.py), which exists in the bundle and is linked clearly ("[find_session.py](scripts/find_session.py)") — a one-level-deep, well-signaled reference with everything else appropriately inline. Not 4 because there are no organization gaps or buried references.

5 / 5

Total

19

/

20

Passed

Description

95%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 is concise, third-person, and concrete: it states multiple specific capabilities and gives explicit quoted trigger phrases for when to use the skill. It is close to ideal; the only minor gap is that ancillary capabilities (filtering/sorting) are not surfaced in the description itself.

DimensionReasoningScore

Specificity

"按对话标题或正文关键词快速定位 DSH 历史会话并读取内容/统计" names several concrete actions — title-keyword search, body-keyword search, content reading, stats reading — but omits some capabilities (project/time filtering, sorting), matching 'several specific actions; minor gaps in coverage'. Not 5 because coverage is not fully comprehensive; not 3 because far more than 1–2 actions are named.

4 / 5

Completeness

Both 'what' (locate sessions by title/body keyword and read content/stats) and 'when' ("用于……等请求", an explicit Use-when clause with concrete trigger phrases) are clearly and explicitly stated. Not 4 because the 'when' is fully explicit with quoted trigger examples, not merely present.

5 / 5

Trigger Term Quality

Natural user phrasings are quoted verbatim — "根据对话名跟踪对话", "查找之前的会话", "查看某会话 token 消耗" — alongside domain terms (对话标题, 正文关键词, token 消耗), covering the common ways a user would ask for this. Not 4 because synonym variations ('track', 'find previous', 'check token usage') are already present rather than missing.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche (DSH 历史会话 lookup) with distinct trigger phrases unlikely to fire for unrelated skills. Not 4 because the DSH-specific scope leaves essentially no overlap with general search or session-management skills.

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

ooooooooooooooooooop/personal-ai

Path

skills/find-session/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.