CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

read-claude-code-history

Reads, searches and exports local Claude Code and Kimi CLI history without resuming work: timelines, verbatim user input, keyword or fuzzy recall, file recovery from transcripts, and which session ran a given command in a known time window. Use when the user asks what was said, wants a session ID or original context, needs proof of what a session contained, or needs past-session runtime evidence about commands, tool calls and hook runs — query this index instead of raw-scanning transcript files. Not for Codex (use read-codex-history); with no platform or several named, start at local-conversation-history.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

A strong operational skill body: routing is unambiguous, commands are exact and verified against the bundle, and validation/checklist discipline is exceptional. The main cost is length — several sections carry reference-grade detail inline that dilutes the overview role of SKILL.md.

Suggestions

Move the tool-evidence mode's exhaustive selector/exit-code/coverage semantics and the four-step Kimi home-discovery procedure into dedicated files under references/, leaving a one-line route plus the key gating rule in SKILL.md.

Trim the dated war story ('战例(2026-09-18)') to its distilled heuristics — the three numbered criteria already capture the rules; the anecdote duplicates them as narrative.

Consolidate the per-mode exit-code semantics (0/1/2) scattered across sections into one small table so each section only states its own deviations.

DimensionReasoningScore

Conciseness

The body is dense with hard operational facts (exit codes, byte caps, copy-divergence gates) rather than padding about known concepts, but sections like the Kimi home-discovery procedure, the tool-evidence flag/exit-code semantics, and the dated '战例(2026-09-18)' anecdote run long and could be tightened or externalized. It sits above 'noticeably verbose' (2) but carries more than 'minor' over-length, matching 'mostly efficient but could be tightened' (3).

3 / 5

Actionability

Every route resolves to an exact, copy-paste-ready command ('scripts/read_claude_session.py --session <ID> --tool-evidence --contains <literal>', 'python3 scripts/skill_usage_ledger.py index'), all of which exist in scripts/, with expected outputs and exit-code semantics stated per mode. This matches the 'fully executable, copy-paste ready, specific examples cover the common cases' anchor; it is not level 4 because no route leaves the executor guessing at flags or arguments.

5 / 5

Workflow Clarity

The routing table maps each user intent to a specific command, and multi-step flows carry explicit validation: recovery runs a report first and writes 'only after the user asked to recover content', the negative-claims section imposes a pre-assertion checklist, and readers 'fail visibly' on divergent copies with prescribed retry ('repeat only this read'). This matches 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'; the destructive-operation cap does not apply because the write path is validated.

5 / 5

Progressive Disclosure

All six referenced files exist in references/ and are one level deep with purpose-conditioned pointers ('Read references/session_file_format.md when interpreting schemas...'), and the nine bundled scripts are real. It falls short of 5 because the SKILL.md body itself inlines substantial reference-grade detail (tool-evidence selector semantics, the four-step Kimi home-location procedure) that belongs in a bundled reference, keeping it at 'good structure; most content appropriately placed; minor organization gaps'.

4 / 5

Total

17

/

20

Passed

Description

92%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 is exemplary: third-person, capability-dense, with an explicit 'Use when' trigger clause and explicit de-scoping against sibling skills. The only gap is a handful of natural synonyms users might phrase differently (conversation, past chat) that would round out trigger coverage.

DimensionReasoningScore

Specificity

The description enumerates concrete capabilities: 'Reads, searches and exports local Claude Code and Kimi CLI history', 'timelines, verbatim user input, keyword or fuzzy recall, file recovery from transcripts, and which session ran a given command in a known time window'. Multiple specific concrete actions with comprehensive coverage, written in third person ('Reads, searches and exports') — this matches the 5 anchor rather than 4, which would require minor coverage gaps.

5 / 5

Completeness

The 'what' is explicit (reads/searches/exports with five enumerated capabilities) and the 'when' is explicit with concrete trigger phrases: 'Use when the user asks what was said, wants a session ID or original context, needs proof of what a session contained, or needs past-session runtime evidence'. It even adds negative routing ('Not for Codex (use read-codex-history); with no platform or several named, start at local-conversation-history'), clearly matching the 5 anchor.

5 / 5

Trigger Term Quality

Natural user phrasings are present: 'what was said', 'wants a session ID or original context', 'needs proof of what a session contained', 'commands, tool calls and hook runs', plus 'transcript files'. Good keyword coverage, but common variations a user might actually say — 'conversation', 'previous chat', 'past sessions', 'what did we do' — are missing, so it fits 'good keyword coverage; a few natural terms missing' (4) rather than comprehensive synonym coverage (5).

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — reading local Claude Code/Kimi history 'without resuming work' — and actively disambiguates adjacent skills: 'Not for Codex (use read-codex-history)' and 'with no platform or several named, start at local-conversation-history'. Distinct triggers and explicit boundary routing give minimal conflict risk, matching the 5 anchor.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

daymade/claude-code-skills

Path

daymade-claude-code/read-claude-code-history/SKILL.md

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.