CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

session-search

Search the session-brain graph for a past agent session by topic and load the winning transcript into the current conversation. Use for finding which session handled X, when Y was last worked on, or whether this was done before. Read-only; requires a session-brain graph.

Quality

88%

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

88%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-crafted, lean procedure that is almost entirely executable guidance: concrete commands, a runnable transcript-filtering snippet, and honest error/fallback handling at every step. Its only structural tradeoff is inlining the ranking-signal detail and filtering recipe in SKILL.md rather than splitting them into reference files, and a couple of minor asides that could be tightened.

DimensionReasoningScore

Conciseness

The body is lean and domain-specific throughout — no explanations of concepts Claude already knows, and directives like 'do not silently rebuild' and 'Never read one whole' are operationally earned. Not a 5: a few spots could be trimmed, e.g. the aside 'This is why a session that never said "telemetry" can still surface for it' and 'Two things must be stated honestly rather than glossed over' spend tokens restating what the surrounding bullets already imply; not a 3 because there is no genuinely unnecessary explanation or padding.

4 / 5

Actionability

Every step ships executable material: 'obsidian-wiki sessions-query "<topic>" --json', the filter flags (--project, --cluster, --since, --top), 'obsidian-wiki sessions-show <session-id> --pretty', and a copy-paste-ready python snippet for filtering human turns from JSONL, plus a 'grep -c' size pre-check. Guidance covers the common cases including the fallback when loader skills are absent — matching 'fully executable; copy-paste ready; specific examples cover the common cases'.

5 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced with explicit checkpoints and feedback loops: exit-1 handling for a missing graph in Step 1, stale-graph detection with a user-consent gate, handling of 'loadable: false' / all-unloadable cases in Step 3, a conditional fallback in Step 4 when personal skills don't exist, and a cite-your-sources requirement in Step 5. The skill is read-only, so no destructive-operation cap applies; this matches 'clear sequence with explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

A single-file skill with well-organized step sections, a 'Related' section that clearly distinguishes sibling skills (/session-brain, wiki-query, wiki-agent), and no nested or buried references — everything referenced (commands, skills) is one level deep. Not a 5: at ~90 body lines it exceeds the under-50-line simple-skill threshold, and some detail (the four ranking-signal explanations and the transcript-filtering recipe) could plausibly live in a reference file to keep the overview leaner; not a 3 because structure is clean and navigation is easy.

4 / 5

Total

18

/

20

Passed

Description

82%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: concrete what, explicit natural-language trigger phrases, and a clearly staked-out niche with an honest precondition. The only soft spot is action coverage — two concrete actions with the ranking/presentation steps left implicit, which keeps specificity at the 1-2-action anchor rather than several-actions territory.

DimensionReasoningScore

Specificity

The description names the domain ('session-brain graph', 'past agent session by topic') and exactly two concrete actions — 'Search the session-brain graph... by topic' and 'load the winning transcript into the current conversation' — matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. Not a 4: the supporting steps (ranking, presenting results, filtering) are absent, so coverage has minor gaps beyond the two stated actions; not below 3 because both actions are concrete and explicitly scoped ('Read-only; requires a session-brain graph').

3 / 5

Completeness

It explicitly answers 'what' ('Search the session-brain graph... and load the winning transcript into the current conversation') and 'when' with concrete trigger phrases ('Use for finding which session handled X, when Y was last worked on, or whether this was done before'), directly matching the anchor-5 good example. Both halves are present, explicit, and trigger-phrased, so 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

'Use for finding which session handled X, when Y was last worked on, or whether this was done before' provides natural user phrasings ('which session handled', 'last worked on', 'was this done before') plus terms like session, transcript, topic. Not a 5: common synonyms users might say — 'chat history', 'conversation history', 'previous session' — are only partially covered; not a 3: keyword coverage is genuinely good with natural phrase-shaped triggers, not just domain jargon.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — searching a specific 'session-brain graph' for past agent sessions, explicitly noting it 'requires a session-brain graph' — with triggers ('which session handled X', 'whether this was done before') unlikely to fire for generic search or wiki skills. Minimal conflict risk; the anchor-5 'clear niche with distinct triggers' fits.

5 / 5

Total

17

/

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

Ar9av/obsidian-wiki

Path

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