CtrlK
BlogDocsLog inGet started
Tessl Logo

session-logs

Search and analyze your own session logs (older/parent conversations) using jq.

58

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/session-logs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a strong, execution-ready skill: fully executable jq/rg recipes covering the realistic use cases, well-organized sections, and terse prose that assumes Claude's competence. The only notable weakness is minor duplication among the text-extraction/search queries, including the redundant "Fast text-only hint" section.

DimensionReasoningScore

Conciseness

The body is command-heavy with minimal prose and no explanation of concepts Claude already knows, but the "Fast text-only hint" section and the "Search for keyword in assistant responses" query substantially duplicate earlier text-extraction recipes and could be trimmed. This is efficient with minor trims available, not fully lean.

4 / 5

Actionability

Every query is a complete, copy-paste-ready bash/jq/rg command covering the common cases: session listing by date/size, day filtering, user/assistant text extraction, keyword search, per-session and daily cost totals, message/token counts, tool-usage breakdown, and cross-session search. Placeholders are concretely resolved, e.g. "use the `agent=<id>` value from the system prompt Runtime line".

5 / 5

Workflow Clarity

The Location → Structure → Common Queries ordering gives a clear implicit sequence (locate the sessions directory, identify the session, run the query), and the Tips section flags pitfalls (large files, sampling with head/tail, deleted-session suffixes). All operations are read-only, so no destructive/batch validation cap applies; it stops short of 5 because no explicit end-to-end workflow is laid out.

4 / 5

Progressive Disclosure

With no bundle files present, all content is inline and organized under clear headers (Trigger, Location, Structure, Common Queries, Tips). Structure is good and most content is appropriately placed for a ~110-line skill; the ~70-line query cookbook could optionally be split into a reference file, which keeps this below the top anchor.

4 / 5

Total

17

/

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 states a concrete, well-scoped capability but omits any explicit "when to use" trigger guidance, which both caps completeness and weakens trigger-term coverage. Adding a "Use when the user asks about prior chats, past conversations, or what was said before" clause would lift the two heaviest dimensions.

Suggestions

Append an explicit trigger clause, e.g. ". Use when the user references older/parent conversations, asks what was said before, or mentions past chats or session history."

Include natural user phrasings as trigger terms — "chat history", "past conversations", "what was said" — alongside the current "session logs" and "older/parent conversations".

Name one or two more concrete outcomes to round out coverage, e.g. "...and summarize costs and message counts per session."

DimensionReasoningScore

Specificity

"Search and analyze" names two concrete actions on a clearly scoped domain ("your own session logs (older/parent conversations)"), but coverage is not comprehensive — no mention of summarizing, extracting costs, or counting. This matches the anchor for naming a domain with 1-2 concrete actions; it is above minimal/generic action wording thanks to the parenthetical scope and tool, but below a multi-action listing.

3 / 5

Completeness

The "what" is clear ("Search and analyze your own session logs ... using jq") but there is no "Use when..." clause or equivalent explicit trigger guidance in the description, which caps completeness at 3. It is not lower because the capability statement itself is concrete and unambiguous.

3 / 5

Trigger Term Quality

Keywords "session logs", "older/parent conversations", and "jq" are relevant, but common natural phrasings users would say — "chat history", "past conversations", "what was said earlier" — are absent (the body contains them, the description does not). Some relevant keywords with missing synonyms matches this anchor; it is below good coverage because several likely trigger phrases are missing.

3 / 5

Distinctiveness Conflict Risk

"your own session logs (older/parent conversations)" carves out a clear niche with distinct triggers and the jq qualifier adds specificity, leaving only minor overlap risk with generic search or memory-file skills. It falls short of the top anchor because the trigger phrasing is thinner than a full what+when example.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
Bitterbot-AI/bitterbot-desktop
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.