CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codex-first

Claude Code / OpenClaw-on-Claude work routing: delegate hands-on work to Codex under the native-Claude model gate. Keep specification, judgment, and verification in Claude; prefer isolated Codex-backed autoreview.

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/codex-first/SKILL.md
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.

The body is an exceptionally actionable, well-gated operations manual with explicit validation checkpoints, error-recovery loops, and a verified one-level-deep reference structure. Its main weakness is token efficiency: dated incident history and version specifics are woven throughout rather than consolidated, which both inflates length and ages poorly.

DimensionReasoningScore

Conciseness

The body is telegraphic and assumes competence — no basic-concept explanations, every line carries operational content — but it is saturated with time-sensitive detail (dates like 2026-10-12/13/15/18/30, versions 0.147 and 0.166.0, incident anecdotes such as "a 27-worker fleet" and "two such watchers drained a shared 5,000/hour writer token") that is not isolated in an old-patterns/deprecated section, which the guidelines say should penalize conciseness. Not 4 because the volume of dated incident history is more than 'minor instances that could be trimmed'.

3 / 5

Actionability

Guidance is fully executable: verbatim copy-paste launch/resume commands, exact error strings to match ("Rate limit reached for gpt-6.1-sol", "thread … already has an active writer"), the exact retry regex ("rate limit|at capacity|overloaded"), concrete probes ("echo <hex> | xxd -r -p", "gh run view <id> --json status,conclusion" at most every ~10 minutes), and named scripts ("codex-resume --stop \"$SID\"", "--dry-run first when unsure"). Common cases (fresh launch, resume, capacity fallback, classifier refusal) are each covered by a specific recipe.

5 / 5

Workflow Clarity

The hard gate is a numbered decision procedure with an explicit fail-closed terminal; the route and invoke sections sequence delegation with validation checkpoints (precheck PR mergeable, confirm a run attached to the exact head SHA, bounded poll iterations, verify launch arguments) and explicit error-recovery feedback loops (capacity → resume on Astra, classifier refusal → relaunch on Daybreak Red, both limited → growing back-off). Land gates ($autoreview clean, CI green, proof) are stated as never-skipped checkpoints. Not 4: validation and recovery loops are explicit throughout, not just 'most checkpoints present'.

5 / 5

Progressive Disclosure

Structure is good and verified against the actual bundle: all four referenced files (launch-details.md, troubleshooting.md, resume-and-watchdog.md, coordination.md) and both scripts (codex-resume, codex-resume.test.sh) exist, are one level deep, and are clearly signaled with purpose statements ("For Fast/catalog checks, CLI setup, or execution details: read [launch details]"). It falls short of 5 because the entrypoint is a dense ~230-line operations manual — e.g. the wrapper/process-hygiene and capacity-fallback incident details — where a leaner overview pushing more mechanics into the references would ease navigation.

4 / 5

Total

17

/

20

Passed

Description

62%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 communicates a distinct, concrete capability split (Claude decides/verifies, Codex implements) with minimal conflict risk, but it lacks any explicit 'use when' trigger clause and leans on internal jargon rather than natural user phrasing. These gaps make it hard for a user or model to know when to invoke it from the description alone.

Suggestions

Add an explicit trigger clause, e.g. "Use when a Claude-powered session needs to delegate implementation, refactors, migrations, test writing, or git/landing mechanics to Codex".

Include natural user phrasings and synonyms — "delegate to Codex", "have Codex implement", "Codex CLI", "work orders" — alongside the existing jargon so the skill triggers on how users actually ask.

Replace or gloss internal shorthand such as "native-Claude model gate" and "OpenClaw-on-Claude" with plain-language conditions (e.g. "when the session runs on a Claude model") to broaden natural-term coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "delegate hands-on work to Codex under the native-Claude model gate", "Keep specification, judgment, and verification in Claude", "prefer isolated Codex-backed autoreview" — in a clearly named domain (work routing). It is not a 5 because coverage is partial: launch-flag policy, capacity fallback, and the delegation route categories in the body are absent, leaving minor gaps.

4 / 5

Completeness

The "what" is clear (route hands-on work to Codex; keep spec/judgment/verification in Claude; prefer Codex-backed autoreview), but there is no "Use when..." clause or equivalent explicit trigger guidance — "under the native-Claude model gate" only weakly implies the condition. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3; it is not 2 because the "what" is concrete, not vague.

3 / 5

Trigger Term Quality

Relevant keywords like "Claude Code", "OpenClaw", "Codex", "delegate", and "autoreview" are present, but natural user phrasings (e.g. "delegate this to Codex", "have Codex implement it", "codex-first") and common synonyms are missing, and jargon like "native-Claude model gate" dominates. This sits at 'some relevant keywords but missing common variations', not 4, which would require noticeably fuller natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

It carves a very specific niche — Claude Code / OpenClaw-on-Claude routing of hands-on work to Codex — with distinct trigger vocabulary ("delegate", "Codex", "autoreview") that would not fire for unrelated skills. Anti-drift check against the 4 anchor ('minor overlap risk with closely related skills'): the only adjacent skills ($codex-huge-context, $maintainer-orchestrator) are not mentioned in the description, so conflict risk is minimal.

5 / 5

Total

15

/

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

referenced_paths_exist

Referenced path issues: 5 missing

Warning

Total

15

/

16

Passed

Repository

steipete/agent-scripts

Path

skills/codex-first/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.