CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codex-environment-creator

Use when a project or Codex runtime needs environment TOML created, triaged, or updated with safe setup, actions, exec-server providers, and validation evidence.

Quality

80%

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/agent-ops/codex-environment-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 runbook with an exemplary validation-first workflow and clean one-level-deep reference architecture. Its main cost is token efficiency: the alias-path drift, dual-file distinction, and cache warnings each repeat across multiple sections, and meta/time-sensitive lines could be cut or consolidated.

Suggestions

State the misspelled alias paths (`.codex/environmental.toml`, `.codex/environmentals/*`) once — in Workflow step 1 — and have Anti-Patterns and Gotchas reference them in a single clause instead of re-enumerating the full list three times.

Consolidate the `$CODEX_HOME/environments.toml` vs repo-local `.codex/environments/environment.toml` distinction into Execution Boundaries (or the referenced environment-authoring.md) and trim the restatements in When To Use, Workflow steps 1 and 9, and Gotchas to one-line cross-references.

Cut meta-content that serves skill maintenance rather than execution ("Use strict skill audit and Plugin Eval when changing this skill", "Apply the context-disposition policy") and fold the repeated cache-invalidation warnings into a single Gotcha, keeping time-sensitive "current ~/dev/codex" observations there rather than in Workflow steps.

DimensionReasoningScore

Conciseness

Mostly efficient runbook prose with no padding about concepts Claude already knows, but it repeats its own material: the misspelled alias paths appear in Workflow step 1, Anti-Patterns, and Gotchas; the $CODEX_HOME vs repo-local distinction is restated four times; cache-invalidation warnings recur across four sections. Meta lines ("Use strict skill audit and Plugin Eval when changing this skill", "Apply the context-disposition policy") and time-sensitive "current ~/dev/codex" statements add tokens without operator value and are not isolated in a deprecated section, fitting anchor 3 rather than 4.

3 / 5

Actionability

Concrete, specific guidance throughout: exact paths (`.codex/environments/environment.toml`, `$CODEX_HOME/environments.toml`), preferred wrapper commands (`./bin/ask`, `make`, `pnpm`, `uv`, `cargo`), and a precise create/triage/update mode taxonomy. It stops short of anchor 5 because the body contains no copy-paste TOML shapes or exact validator commands (e.g. a tomllib one-liner), deferring those to references — a minor gap for an instruction-only runbook.

4 / 5

Workflow Clarity

The 10-step Workflow is clearly sequenced with an explicit validation step ("Validate with the smallest real check... Report exact pass, fail, or blocked outcomes"), a fail-fast feedback loop ("Fail fast at the first failed gate; fix and rerun before claiming completion"), and error-recovery guidance in Failure Mode ("separate pre-existing repo failure from the environment-file change and rerun only after a targeted fix"). This matches anchor 5: explicit validation, feedback loops, and itemized triage checklists.

5 / 5

Progressive Disclosure

The body serves as the overview and all five referenced files exist, are exactly one level deep, and each is signaled with an explicit purpose: contract.yaml and evals.yaml for machine-readable contract/benchmark coverage, task-profile.json for evaluator thresholds, and "Read when" conditions for environment-authoring.md and provider-examples.md. This matches anchor 5's clear overview with well-signaled one-level-deep references.

5 / 5

Total

17

/

20

Passed

Description

75%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 solid description in third-person trigger form that clearly names its niche (Codex environment TOML) and its three modes of operation. Its main gaps are missing the concrete filename triggers (environment.toml, the environmental.toml misspelling) and an abstract rather than phrase-level 'when' clause.

DimensionReasoningScore

Specificity

Names the artifact (environment TOML) and three concrete operations ("created, triaged, or updated"), plus covered areas ("safe setup, actions, exec-server providers, and validation evidence"). The trailing list reads as compressed coverage categories rather than fully distinct concrete actions, so it falls just short of the comprehensive anchor 5.

4 / 5

Completeness

Both parts are present: what ("environment TOML created, triaged, or updated with safe setup, actions, exec-server providers") and an explicit when ("Use when a project or Codex runtime needs..."). The when clause is abstract — it names conditions rather than concrete user-mentionable trigger phrases (e.g. "when the user mentions environment.toml or Codex setup"), so it fits anchor 4, not 5.

4 / 5

Trigger Term Quality

"Codex", "environment TOML", "setup", and "triaged" are natural terms a user might say. However the concrete filename triggers users actually produce — "environment.toml", the common "environmental.toml" misspelling the skill itself documents, and ".codex/environments" — are missing, matching anchor 4 (good coverage, a few natural terms missing) rather than 5.

4 / 5

Distinctiveness Conflict Risk

"Codex runtime" and "exec-server providers" carve a clear niche that would rarely trigger for unrelated skills. Minor overlap remains with closely related skills (the referenced [[toml]] and [[bootstrap]] skills, generic environment/setup tooling), and "environment TOML" without the .codex path could tug at broader config-file skills — anchor 4 rather than 5.

4 / 5

Total

16

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

jscraik/Agent-Skills

Path

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