CtrlK
BlogDocsLog inGet started
Tessl Logo

session-logs

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

64

Quality

78%

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

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an efficient, highly actionable reference of executable session-log queries with clean organization and no padding. It exemplifies a well-structured single-purpose skill.

DimensionReasoningScore

Conciseness

The body is lean: short section intros followed directly by executable jq/rg/bash snippets, with no preamble explaining what JSONL or jq is, so every token earns its place per the score-3 anchor.

3 / 3

Actionability

It provides numerous concrete, copy-paste-ready commands (e.g. the jq filter for user messages and the daily-cost awk summary), fully executable without pseudocode, matching the score-3 anchor.

3 / 3

Workflow Clarity

As a single-purpose skill the content is clearly organized into categorized query recipes; the operations are read-only analysis so the destructive/batch feedback-loop cap does not apply, and the scoring note allows a 3 for clear single-purpose skills.

3 / 3

Progressive Disclosure

The skill has no bundle files and is self-contained with well-organized sections (Trigger, Location, Structure, Common Queries, Tips) and no nested external references, so it meets the well-organized-sections criterion for a 3.

3 / 3

Total

12

/

12

Passed

Description

57%

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 the tool used, but stops short of a fully explicit trigger clause and uses the somewhat abstract verb 'analyze'. Adding a 'Use when...' clause and more concrete action verbs would raise specificity and completeness.

Suggestions

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

Replace or supplement the abstract 'analyze' with concrete actions such as 'list, search, extract messages, and summarize costs from'.

Broaden trigger-term coverage with natural variations like 'chat history', 'past messages', or 'conversation transcript'.

DimensionReasoningScore

Specificity

The description names the domain ('session logs (older/parent conversations)') and two actions ('Search and analyze') plus the tool ('jq'), but 'analyze' is abstract and the action list is not comprehensive, matching the score-2 anchor rather than the multi-action score-3 example.

2 / 3

Completeness

It states what the skill does ('Search and analyze your own session logs') but lacks an explicit 'Use when...' trigger clause; per the judging guidelines a missing explicit trigger guidance caps completeness at 2.

2 / 3

Trigger Term Quality

'session logs' and 'older/parent conversations' are natural phrases a user might say, but coverage of common variations is limited (no mention of 'chat history', 'past messages', or 'what I said before'), fitting the 'some relevant keywords but missing common variations' anchor.

2 / 3

Distinctiveness Conflict Risk

Searching one's own session logs via jq is a clear, narrow niche unlikely to trigger for unrelated skills, matching the 'clear niche with distinct triggers' anchor.

3 / 3

Total

9

/

12

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.