CtrlK
BlogDocsLog inGet started
Tessl Logo

session-logs

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

60

Quality

71%

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.

The content is a tight, highly actionable jq recipe collection with excellent executable examples and clear organization. Its main weakness is minor redundancy between the keyword-search query and the trailing fast-hint section.

DimensionReasoningScore

Conciseness

The body is lean and code-driven with minimal prose and no over-explanation of concepts Claude already knows; the only redundancy is the trailing 'Fast text-only hint' section which overlaps an earlier query, keeping it just below a 5.

4 / 5

Actionability

Provides many fully executable, copy-paste-ready jq and bash commands covering common cases (list sessions, extract roles, keyword search, cost totals, tool usage), matching the anchor for executable coverage of common cases.

5 / 5

Workflow Clarity

Queries are clearly organized by task with consistent structure, and operations are read-only so no validation checkpoints are required; it is a recipe toolkit rather than a sequenced multi-step workflow, so it sits just below 5.

4 / 5

Progressive Disclosure

Well-organized into clear sections (Trigger, Location, Structure, Common Queries, Tips) with easy navigation and no nested references; self-contained content is appropriately inlined for a focused skill, though it exceeds 50 lines so the simple-skill carve-up does not strictly apply.

4 / 5

Total

17

/

20

Passed

Description

61%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 clearly identifies a distinct niche and tool, but it is missing an explicit 'Use when' trigger clause, which caps its completeness. Specificity is adequate but the action verbs are generic.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks about prior chats, parent conversations, or what was said before in older sessions.'

Replace generic verbs with more specific actions like 'list, filter, and extract messages from session logs' to raise specificity.

Include natural synonyms users might say, such as 'chat history' or 'previous conversations', to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain ('session logs') and two concrete actions ('Search and analyze') plus the tool ('jq'), but the verbs are generic and coverage is not comprehensive, matching the anchor for 1-2 concrete actions.

3 / 5

Completeness

Has a clear 'what' (search and analyze session logs via jq) but no explicit 'Use when...' trigger clause; the parenthetical only weakly implies when, so completeness is capped at 3 per the guidelines.

3 / 5

Trigger Term Quality

Includes natural phrases users would say ('older/parent conversations', 'session logs') with good coverage, though synonyms like 'chat history' or 'previous chats' and the .jsonl extension are absent.

4 / 5

Distinctiveness Conflict Risk

Targets a clear niche (personal bitterbot session logs via jq) with distinct triggers and minimal conflict risk, though 'search and analyze' is generic enough to invite minor overlap with other search skills.

4 / 5

Total

14

/

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.

Validation14 / 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.