CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

search

Use when the user wants to find prior work, checkpoints, or agent conversations by topic, repo, branch, author, or recent time window

68

Quality

86%

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

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

An exemplar instruction-only skill body: every line prescribes behavior or gives an executable command, error recovery is built into each step, and the structure is tight with no filler. No improvements identified.

DimensionReasoningScore

Conciseness

The body is lean and fully operational — "Use `entire search` to find relevant checkpoints before guessing from memory" plus fenced command blocks and terse section headers (Response Format, When to Use, Process, Search Heuristics, Failure Modes) with zero concept explanations or padding. Nothing can be trimmed without losing instruction, matching the 'every token earns its place' anchor.

5 / 5

Actionability

All guidance is copy-paste executable: `entire search "<query>" --json`, a fully-dimensioned filter example (`--repo owner/name --branch branch-name --author "Name" --date week`), inline filter syntax (`author:<name>`, `repo:*`), and drill-down with `entire explain --checkpoint <checkpoint-id> --full --no-pager`. Commands cover the common cases including the failure path, so it exceeds the 'mostly executable, minor gaps' anchor.

5 / 5

Workflow Clarity

A clear three-step sequence (focused search → review/summarize candidates → drill into a checkpoint) with explicit error-recovery loops: "If `--full` fails, fall back to" the `--raw-transcript` variant, a broadening order ("remove branch filter, widen date, simplify query terms"), and a Failure Modes section covering auth (`entire login`) and empty results. The read-only skill involves no destructive/batch operations, so no validation cap applies.

5 / 5

Progressive Disclosure

The ~66-line body is self-contained with well-organized sections and no bundle files; nothing that belongs in a separate file is inlined, there are no nested references, and navigation is trivial. This fits the simple-skill pattern where clean section organization alone earns full marks.

5 / 5

Total

20

/

20

Passed

Description

66%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 specific and trigger-rich, but it is entirely a "when" clause: it never states what the skill actually does (run `entire search` over past checkpoints), so completeness is the weak spot. It is otherwise clearly scoped to a niche domain with modest overlap risk.

Suggestions

Lead with an explicit what-statement before the trigger clause, e.g. "Searches past checkpoints and agent conversations via the entire CLI, surfacing likely matches and full transcripts.", then keep the existing "Use when..." sentence.

Add natural synonyms users would actually say: "past sessions", "have we done this before", "previous implementation", "search history".

Add a boundary phrase such as "for prior sessions only — not the current one" to reduce collision with the session-handoff skill.

DimensionReasoningScore

Specificity

"find prior work, checkpoints, or agent conversations by topic, repo, branch, author, or recent time window" lists several concrete searchable targets and filter dimensions, going beyond the 1-2-action anchor. It is not a 5 because the action vocabulary is a single verb ("find") — capabilities like summarizing matches or opening a specific checkpoint appear only in the body, leaving minor coverage gaps.

4 / 5

Completeness

Only a "when" clause is present ("Use when the user wants to find..."); the "what" — which tool is run and what actions are taken — is never stated as a capability, only implied through the when-clause's object list. It is above the anchor-2 example ("Use when working with documents") because the embedded what is specific, but below anchor 4 because the what is not explicit.

3 / 5

Trigger Term Quality

Natural phrases like "find prior work", "checkpoints", "agent conversations", "repo", "branch", "author", and "recent time window" give good keyword coverage. It falls short of the comprehensive anchor because common user variations such as "past sessions", "history", or "have we done this before" are missing.

4 / 5

Distinctiveness Conflict Risk

The checkpoint/prior-work framing with repo, branch, and author filters carves a clear niche, but generic phrasing like "find prior work" could overlap with codebase-search or memory-recall skills. Not a 5 also because disambiguation from the current-session case (the body's `session-handoff` handoff) is absent from the description itself.

4 / 5

Total

15

/

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

SnowingFox/ai-skills

Path

.agents/skills/search/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.