CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codex-agent-creator

Create, validate, install, fold, or troubleshoot Codex subagent role TOML, agents-table config, discoverability wiring, and duplicate-role merges. Use when a user asks for a Codex agent role, reviewer agent, role config, TOML role file, subagent setup, or overlapping agents to merge.

Quality

91%

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

85%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 well-structured instruction-only skill: lean imperative sections, concrete schema fields and validation commands, a sequenced workflow with explicit gate/rerun feedback loops, and correctly delegated detail in verified one-level-deep references. Remaining gaps are mild abstraction in a few workflow steps and minor trimmable redundancy.

DimensionReasoningScore

Conciseness

The body is dense and imperative throughout ('Build the smallest role surface that can be validated from current Codex evidence') with no explanations of concepts Claude already knows, but there is minor redundancy between the Purpose and When to Use sections and slightly padded Discovery Interview bullets ('Explain why this matters for the current skill decision'), fitting the 'minor instances of over-explanation that could be trimmed' anchor rather than the lean top level.

4 / 5

Actionability

Concrete guidance is abundant — exact schema fields ('`description`, `config_file`, and `nickname_candidates`; keep `agents.max_depth >= 1`'), real source anchor paths, and copy-paste validation commands — but some workflow steps remain abstract ('Verify current Codex role schema, `spawn_agent` surface...') and the role template is fully delegated to references, matching 'mostly executable guidance... with minor gaps' rather than fully executable.

4 / 5

Workflow Clarity

The nine-step Workflow is clearly sequenced with validation embedded (step 8) and backed by a dedicated Validation section with an explicit feedback loop ('Stop at the first failed gate, fix that failure class, and rerun it') and concrete gate commands — matching the top anchor's 'explicit validation steps; feedback loops for error recovery'. The destructive/batch cap does not apply since validation is present.

5 / 5

Progressive Disclosure

A clear, sectioned overview with well-signaled, one-level-deep references — role-creation-guide.md, role-config-examples.md, contract.yaml, evals.yaml, and discovery-interview.md all exist in references/ — with template and contract detail appropriately split out and a consolidated References section. This matches the top anchor.

5 / 5

Total

18

/

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 multi-verb capability statement, explicit and specific 'Use when' trigger clause, and a tightly scoped niche. The only weakness is trigger-term coverage, which lacks file-extension forms ('.toml') and broader synonyms.

DimensionReasoningScore

Specificity

Lists five concrete actions ('Create, validate, install, fold, or troubleshoot') applied to specific artifacts ('Codex subagent role TOML, agents-table config, discoverability wiring, and duplicate-role merges'), comprehensively covering the skill's surfaces with no notable gaps — matching the top anchor rather than the 'minor gaps' level 4.

5 / 5

Completeness

Explicitly answers both what (first sentence enumerating concrete actions and artifacts) and when ('Use when a user asks for a Codex agent role, reviewer agent, role config, TOML role file, subagent setup, or overlapping agents to merge') with concrete trigger phrases — a verbatim match for the top anchor.

5 / 5

Trigger Term Quality

The 'Use when' clause supplies six natural triggers a user would plausibly say ('Codex agent role', 'reviewer agent', 'role config', 'TOML role file', 'subagent setup', 'overlapping agents to merge'), but coverage is not comprehensive: no '.toml' file-extension form and few synonyms beyond 'role file/role config'. This fits the 'good keyword coverage; a few natural terms missing' anchor rather than the top level.

4 / 5

Distinctiveness Conflict Risk

'Codex' scoping combined with TOML role files and agents-table config carves a clear niche with distinct triggers; it would not fire for generic agent-creation or document skills, satisfying the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jscraik/Agent-Skills

Path

Skills/agent-ops/codex-agent-creator/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.