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?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

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