CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

read-codex-history

Reads, searches and exports local OpenAI Codex history without continuing work: session inventory, timelines, verbatim user input, indexed search, and rollout identity/fork lineage. Use when the user asks what they told Codex, wants a Session ID, or evidence of what a run did. Not for Claude Code (use read-claude-code-history); with no platform 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 highly actionable, well-guarded body: every workflow ends in executable commands with explicit identity verification, gap reporting, and error-recovery loops. Its weakness is token weight — date-stamped measurements, index statistics, and long contract prose are inlined where a reference file would keep the overview lean.

Suggestions

Move the 'Alternative indexed full-text lookup' constraint bullets (tokenizer behavior, measured row counts, timing comparisons) into a reference file and keep only the query plus the freshness/kind-filter rules inline.

Relocate the runtime-log SQL examples and the 'Pitfalls measured 2026-10-03' block into references/storage_and_portability.md (or a dedicated reference), leaving the error-shape bucketing guidance and a pointer in SKILL.md.

Rewrite the 'Bounded current-thread direct input cursor' section as short bullet points with a link to a reference for the full invariants contract, and trim the reconciler prose in 'Route by the requested result' to the essential exit-2/`complete: false` handling.

DimensionReasoningScore

Conciseness

Mostly operational with no filler or explanations of known concepts, but it could be tightened: the ~30-line FTS tokenizer/measurement bullets (row counts like "10 rows against 163 substring occurrences", "measured 26s against 0.03s"), the date-stamped "Pitfalls measured 2026-10-03" block, and the dense single-paragraph prompt_cursor contract are inline detail that belongs in reference files. It is above the score-2 anchor (no padded or unnecessary concept explanations) but clearly below score-4 because multiple sections carry measurement trivia and time-sensitive specifics that tax the context budget.

3 / 5

Actionability

Every route ends in a copy-paste-ready invocation with concrete flags (e.g. `read_codex_session.py --session <ID> --tools --contains '<literal clue>' --format json`, `analyze_sessions.py locate-codex <ID>`) and the SQL for the runtime log is complete and executable. The `<skill-dir>` placeholders are explicitly resolved by the instruction "Resolve scripts relative to this SKILL.md", matching the score-5 anchor of fully executable commands covering common cases.

5 / 5

Workflow Clarity

Workflows are explicitly sequenced with validation checkpoints and feedback loops: candidate selection → identity verification → "Stop once the quote and identity are verified" → "If a candidate misses, try the remaining plausible candidates"; a numbered 3-step identity/lineage gate; and a 5-item read-result contract checklist. Error handling is prescribed throughout (exit 2 / `complete: false` as incomplete, briefing safety-limit failures, zero-row scoping), matching the score-5 anchor including checklists and recovery loops.

5 / 5

Progressive Disclosure

Structure is good: four real reference files one level deep, each clearly signaled with a purpose statement ("Read [storage_and_portability.md] for source discovery, timestamps, writer-lock semantics..."), verified anchor links, and a route-by-result table for navigation. It is not score-5 because a substantial amount of deep material (the FTS index constraints section, the runtime-log SQL and pitfalls, the prompt_cursor contract) is inlined in SKILL.md rather than split out, which is the score-4 anchor's '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.

A strong description: concrete, third-person capability list, an explicit 'Use when' trigger clause, and active disambiguation against sibling history-reading skills. The only gap is modest synonym coverage for natural trigger phrases.

DimensionReasoningScore

Specificity

The description enumerates concrete capabilities — "session inventory, timelines, verbatim user input, indexed search, and rollout identity/fork lineage" — plus the read-only boundary ("without continuing work"), comprehensively covering the skill's surfaces in third person. It exceeds the score-4 anchor ('several specific actions; minor gaps') because no capability area of the skill is left unrepresented.

5 / 5

Completeness

Both questions are explicitly answered: the "what" opens with the enumerated actions, and the "when" is a concrete 'Use when' clause listing three trigger scenarios. It matches the score-5 example structure exactly and additionally supplies boundary routing, so it cannot be the score-4 anchor ('when' could be more explicit).

5 / 5

Trigger Term Quality

Natural user phrasing is present — "what they told Codex", "wants a Session ID", "evidence of what a run did", "Codex history" — which users would genuinely say. It falls short of the score-5 anchor because common synonyms and variations like "transcript", "past conversation", "chat log", or file-format terms are absent.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous (local OpenAI Codex history, read-only) and it actively de-conflicts the two nearest sibling skills: "Not for Claude Code (use read-claude-code-history); with no platform named, start at local-conversation-history". This explicit routing gives minimal conflict risk, matching the score-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-codex-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.