session-logs
Search and analyze your own session logs (older/parent conversations) using jq.
74
Quality
63%
Does it follow best practices?
Impact
94%
1.91xAverage score across 3 eval scenarios
Risky
Do not use without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/skills/session-logs/SKILL.mdQuality
Discovery
40%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 identifies a clear, distinctive niche (analyzing session logs with jq) but suffers from incomplete guidance. It lacks explicit trigger conditions and could benefit from more natural user keywords. The specificity of actions is moderate but not comprehensive.
Suggestions
Add a 'Use when...' clause with explicit triggers like 'Use when the user wants to search previous conversations, review chat history, or query session data'
Include more natural trigger terms users might say: 'chat history', 'previous sessions', 'conversation history', 'past messages', 'log analysis'
Expand specific actions: 'Search, filter, and analyze session logs - find specific messages, aggregate conversation data, query JSON logs using jq'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (session logs) and mentions two actions (search and analyze) plus the tool (jq), but doesn't list comprehensive specific actions like filtering, querying specific fields, or aggregating data. | 2 / 3 |
Completeness | Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes some relevant terms like 'session logs', 'older/parent conversations', and 'jq', but misses common variations users might say like 'chat history', 'previous sessions', 'conversation history', or 'log files'. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of 'session logs', 'older/parent conversations', and 'jq' creates a clear niche that is unlikely to conflict with other skills - this is a very specific use case. | 3 / 3 |
Total | 8 / 12 Passed |
Implementation
87%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, well-crafted skill that provides actionable jq queries for searching session logs. It's concise, assumes Claude's competence, and organizes content logically. The only minor weakness is the lack of error handling guidance for edge cases like empty sessions or malformed data.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its place with no unnecessary explanation of what JSONL is or how jq works. The skill assumes Claude's competence and provides only the specific patterns needed for this task. | 3 / 3 |
Actionability | All examples are fully executable bash/jq commands that can be copy-pasted directly. The queries cover common use cases with specific, working code rather than pseudocode or vague descriptions. | 3 / 3 |
Workflow Clarity | This is primarily a reference skill with independent queries rather than a multi-step workflow. However, there's no guidance on what to do if queries return unexpected results or how to handle malformed JSONL files, which would help with error recovery. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear sections (Trigger, Location, Structure, Common Queries, Tips). For a reference-style skill under 100 lines, the single-file approach with logical groupings is appropriate and easy to navigate. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 9 / 11 Passed | |
- Repository
- trpc-group/trpc-agent-go
- Commit
8763418
- 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.