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.

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 highly actionable, contract-driven skill body: every route has an exact command, expected output, exit codes, and explicit validation/feedback loops, and reference navigation is real and purpose-scoped. Its weakness is length — repeated identity/coverage caveats and inline reference-grade material (Kimi home hunting, a dated war story) make it heavier than the task requires.

Suggestions

Move the four-step Kimi home-location procedure and its schema facts into a dedicated reference file (e.g. references/kimi-home-resolution.md), keeping only the routing sentence and the 'no home found vs. no conversations' distinction in SKILL.md.

State the divergent-copy/Session-identity validation gates once (e.g. in a short 'Evidence integrity' section) and reference it from the briefing, tool-evidence, and SHA-256 sections instead of repeating the full list three times.

Replace the dated 战例 anecdote with its distilled heuristics (time-filter first, include scratchpad, recovered-version ≠ final-version) and drop the specific 2026-09-18 incident details, or relocate the war story to workflow examples.

DimensionReasoningScore

Conciseness

The body is dense and nearly everything is non-obvious operational contract (identity gates, exit-code semantics, coverage limits), so it avoids explaining known concepts — but it is still noticeably over budget: the divergent-copy/identity-gate caveats are restated at least three times (briefing, tool-evidence, SHA-256 sections), a dated war story ("战例(2026-09-18):找「之前做的聚类网页」...") with time-sensitive specifics sits inline, and the four-step Kimi home-location procedure with schema facts is reference material living in the main file. This fits 'mostly efficient but could be tightened'; it is not 2 because the padding is redundancy of load-bearing detail rather than explanations of things Claude already knows, and not 4 because several sections (Kimi routing, tool-evidence contract minutiae) need real trimming or extraction, not minor cuts.

3 / 5

Actionability

Commands are copy-paste ready with exact flags and placeholders ("read_claude_session.py --session <ID> --tool-evidence --contains '<literal>'", "analyze_sessions.py tool-calls --from <ISO> --to <ISO> --pattern <REGEX>"), each accompanied by expected output shape, exit-code semantics ("Exit 0 means at least one selected group, 1 means no match... 2 means invalid arguments"), and precise filter semantics ("Datetimes require a timezone; date-only bounds use the machine's local day"). Fully executable guidance with specific examples covering the common cases; no gaps justify 4.

5 / 5

Workflow Clarity

A routing table maps every request shape to a concrete command; procedures have explicit validation checkpoints and feedback loops — the Kimi home location ends with "Confirm before using it" plus a concrete pass test ("A real Kimi home contains session_index.jsonl and a sessions/wd_<workspace>_<hash>/ tree"), recovery requires reviewing the report before adopting files, and the surface-fingerprint contract specifies a re-read loop ("If it differs from the fingerprint you last saw... re-read this SKILL.md"). The negative-claim checklist ("Before writing any negative or absolute claim... complete this checklist") is an explicit error-recovery gate for the skill's riskiest failure mode. This matches the anchor for clear sequence with explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

References are well-signaled, purpose-scoped ("Read [references/session_file_format.md] when interpreting schemas, authorship, sidechains..."), and all resolve to real bundle files including a verified deep anchor; nested links exist only inside the explicitly frozen legacy snapshot. It is not 5 because the split is uneven: substantial self-contained detail (the full Kimi home-resolution procedure, tool-evidence byte-cap/coverage contract, the dated heuristic section) remains inline in SKILL.md where the pattern of this bundle would put it in a reference file — good structure with minor organization gaps rather than a clean overview pointing one level deep.

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.

An excellent description: concrete multi-capability statement in third person, an explicit 'Use when' clause with realistic trigger phrases, and explicit boundaries against the sibling Codex skill and the cross-provider router. The only gap is modest synonym coverage of natural user phrasings, which keeps trigger term quality at 4 rather than 5.

DimensionReasoningScore

Specificity

The description enumerates five distinct 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" — which is comprehensive, concrete coverage of the skill's surface, matching the anchor for multiple specific concrete actions. It is not 4 because there are no meaningful coverage gaps: reading, searching, exporting, recovery, and attribution queries are all named.

5 / 5

Completeness

It explicitly answers both questions with concrete triggers: the "what" is the full capability list, and an explicit "Use when the user asks what was said, wants a session ID or original context, needs proof of what a session contained..." clause gives concrete trigger phrases. This mirrors the 5 anchor ('clearly and explicitly answers both what AND when with concrete trigger phrases') and adds explicit negative boundaries, so it cannot be 4 where the 'when' is only partially explicit.

5 / 5

Trigger Term Quality

Natural user phrasing is well represented — "what was said", "wants a session ID", "proof of what a session contained", "commands, tool calls and hook runs", plus scope terms like "history" and "transcript files". It is not 5 because common synonyms a user would naturally say ("past conversation", "previous session", "yesterday's chat", "find that thing we built") are absent, though the covered terms are exactly what users ask for in this domain; it is clearly above the midpoint of 'some relevant keywords with missing variations'.

4 / 5

Distinctiveness Conflict Risk

The niche is sharply defined (local Claude Code and Kimi CLI history evidence) with explicit conflict disambiguation: "Not for Codex (use read-claude-code-history)" and a router handoff ("with no platform or several named, start at local-conversation-history"). Explicit de-scoping of the nearest sibling skill and a routing rule give minimal conflict risk, matching the clear-niche anchor; nothing places it at 4, since the overlapping skills are named and redirected rather than merely distinguished by topic.

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.