CtrlK
BlogDocsLog inGet started
Tessl Logo

session-search

For CLI agents WITHOUT subagent support (e.g., Codex CLI). Search previous code agent sessions for specific work, decisions, or code patterns.

54

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./plugins/aichat/skills/session-search/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 tight, actionable runbook: concrete commands, a bounded workflow, clear constraints, and error handling. Its main weaknesses are the ambiguous dual-package install section and a small execution gap in the jq parsing step.

Suggestions

Pick one recommended install path and demote the alternative to a parenthetical, removing the unexplained "Node.js 18+ (for action menus)" prerequisite.

Show the actual jq filter for step 3 (e.g., `aichat search --json -n 10 "[query]" | jq -r '.[] | "\(.session_id) \(.created): \(.snippet)"'`) so parsing is copy-paste ready.

DimensionReasoningScore

Conciseness

The body is mostly lean, command-first prose, but the error-handling section offers two alternative packages ("uv tool install claude-code-tools" / "cargo install aichat-search") with no guidance on choosing between them, plus tangential curl installers and a prerequisite ("Node.js 18+ (for action menus)") referencing a feature never explained. Not 2 because the core workflow is efficient and unpadded; not 4 because the install block's choice-parity and stray prerequisite are unnecessary content.

3 / 5

Actionability

Concrete executable commands appear throughout — `aichat search --json -n 10 "[query]"` with the `-g "project"` filter, the session-file path pattern `~/.claude/projects/*/[session-id].jsonl`, and a worked example. Not 5 because step 3 says "Use `jq` to extract fields" without showing the actual jq expression, leaving a small execution gap.

4 / 5

Workflow Clarity

The five-step workflow is clearly sequenced (understand → search → parse → deep-dive with a 3-file cap → summarize) and includes error-recovery paths ("If no results found, suggest alternative search terms" and the command-failure handling section). Not 5 because checkpoints are implicit in the step list rather than embedded as explicit validation steps; the read-only nature of the skill means no destructive/batch cap applies.

4 / 5

Progressive Disclosure

Sections are clean and well-labeled (Workflow, Output Format, Example, Constraints, Error Handling) and the skill is appropriately self-contained with no bundle files or nested references. Not 5 because the ~74-line body exceeds the under-50-line simple-skill exception and the install/prerequisites block is a minor organization gap mixing recovery guidance with environment setup.

4 / 5

Total

15

/

20

Passed

Description

53%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 communicates a clear, distinct purpose in compact form, but is held back by a missing user-task trigger clause and thin synonym coverage. It states what the skill does without saying when a user would need it.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks about past sessions, previous decisions, or work done in an earlier conversation (e.g., 'what did we decide about auth?')."

Include common synonyms such as "session history", "past conversations", or "transcripts" so natural user phrasings match.

Enumerate the concrete capabilities (search, parse results, deep-dive into session files, summarize findings) rather than only "Search".

DimensionReasoningScore

Specificity

"Search previous code agent sessions for specific work, decisions, or code patterns" names the domain and one concrete action with its search targets, but stops short of the several specific actions (parse, deep-dive, summarize) the skill actually performs. Not score 2 because the action and targets are concrete rather than generic; not 4 because only one action is enumerated.

3 / 5

Completeness

The "what" is clear (search previous sessions for work, decisions, patterns), but there is no user-task "Use when..." clause — the only conditional is the agent-scoping "For CLI agents WITHOUT subagent support (e.g., Codex CLI)", which addresses which agent should invoke it, not when the task arises. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms like "search", "sessions", "decisions", and "code patterns" are present, but common variations users would say — "history", "past conversations", "transcripts", "find" — are absent. Not 4 because the missing synonyms are among the most likely user phrasings for this need.

3 / 5

Distinctiveness Conflict Risk

"Previous code agent sessions" carves a clear niche, and the agent-conditional scoping further separates it from sibling skills (e.g., a subagent-based equivalent). Not 5 because somewhat generic phrases like "code patterns" and "specific work" leave minor overlap risk with general search or memory skills.

4 / 5

Total

13

/

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
pchalasani/claude-code-tools
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.