CtrlK
BlogDocsLog inGet started
Tessl Logo

lirantal/codex-chat-organizer

Move existing Codex chats/threads into saved Codex Projects by resolving chat titles and project names, generating a safe move plan, and launching a terminal helper that quits Codex, patches local Codex state after exit, then reopens Codex. Use when the user asks to organize Codex chats by Project, move chats into Projects, re-parent projectless Codex threads, or fix chats appearing outside the intended Project.

79

Quality

99%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

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 well-structured and concise with a concrete, executable workflow and explicit safety/validation checkpoints for a fragile state-editing operation. The one genuine weakness is bundle completeness: two referenced executables are missing from the scripts directory.

Suggestions

Add the missing `scripts/apply-move-plan.mjs` patcher that `run-move-helper.sh` invokes (lines 55, 60, 81) — without it the helper cannot run and the documented workflow is non-functional end-to-end.

Either add `scripts/test-fixture.mjs` or remove the reference to it in the Validation section — the file is absent from the bundle, so the stated `scripts/test-fixture.mjs` validation command cannot actually be run.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it never explains what Codex, Projects, or SQLite backups are, and every section (Overview, Workflow, Move Plan, Safety Requirements) earns its place without concept padding.

3 / 3

Actionability

Provides a complete copy-paste-ready JSON plan shape, an exact launch command (`scripts/launch-chat-organizer.sh /tmp/codex-chat-organizer-plan.json`), and concrete options/flags, matching the fully-executable anchor; the primary referenced launcher exists in the bundle.

3 / 3

Workflow Clarity

A clear 5-step sequenced workflow is paired with explicit validation/safety checkpoints — confirmation prompt, backup, verify-the-result, and "failed verification must stop the move" feedback loop — so the destructive operation is not capped at 2.

3 / 3

Progressive Disclosure

Content is appropriately split into clearly signaled, one-level-deep script references (`scripts/launch-chat-organizer.sh`) with well-organized sections, rather than an inline wall of text; the main referenced script resolves to a real bundle file.

3 / 3

Total

12

/

12

Passed

Description

100%

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, third-person description that states concrete capabilities and provides explicit, natural-language trigger guidance for a clearly distinct niche. Voice is correctly third person ("Move existing Codex chats...") with no first/second-person phrasing.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "resolving chat titles and project names", "generating a safe move plan", "launching a terminal helper that quits Codex, patches local Codex state after exit, then reopens Codex" — matching the multiple-specific-actions anchor.

3 / 3

Completeness

Explicitly answers both what (the move/plan/patch/reopen actions) and when via a dedicated "Use when the user asks to..." clause with multiple triggers, satisfying the both-what-and-when anchor.

3 / 3

Trigger Term Quality

The "Use when" clause covers natural phrasings a user would say — "organize Codex chats by Project", "move chats into Projects", "re-parent projectless Codex threads", "fix chats appearing outside the intended Project" — giving good coverage of real trigger terms.

3 / 3

Distinctiveness Conflict Risk

The scope is tightly bound to Codex chats and Codex Projects with Codex-specific triggers, giving it a clear niche unlikely to fire for unrelated skills.

3 / 3

Total

12

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents