CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

boris

Codex workflow tips from Boris Cherny and the Codex team. Use when setting up Codex or optimizing workflows: parallel sessions, worktrees, plan mode, AGENTS.md, skills, subagents, hooks, MCP, permissions, and sandboxing.

Quality

75%

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 ./.agents/harness/adapters/antigravity/skills/boris/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 a maximally concise delegation stub that points to a shared external skill file. While token-efficient and unambiguous as an instruction, it provides no standalone actionable content and depends entirely on an unbundled external path, which caps actionability and progressive disclosure at the midpoint.

Suggestions

Inline a brief summary of the core Codex recommendations (or bundle the shared content under references/) so the skill remains actionable if `~/.agents/skills/boris/SKILL.md` is unavailable.

Add a fallback instruction, e.g. 'If that file does not exist, ask the user where the shared boris skill is installed', to give the single-step workflow a validation checkpoint.

Move the referenced material into a bundled references/ file so the one-level-deep reference stays within the skill directory and survives relocation.

DimensionReasoningScore

Conciseness

The body is two lean lines — a provenance comment and "Load and follow the shared skill at `~/.agents/skills/boris/SKILL.md`" — with zero padding, no explanation of concepts Claude already knows, and every token earning its place. This matches the anchor 5 'Lean and efficient; assumes Claude's competence' example.

5 / 5

Actionability

The single instruction is concrete — an exact, unambiguous file path to load — but the actual guidance (the Codex workflow tips themselves) is entirely absent from the body, leaving only a pointer with all key details in an external file. This fits anchor 3's 'concrete guidance but incomplete; missing key details' better than anchor 4, which expects mostly complete executable guidance.

3 / 5

Workflow Clarity

As a single-purpose skill, its one action (load and follow the shared skill) is unambiguous, which per the simple-skill guideline supports a high score. It falls short of 5 because the workflow depends wholly on an external file with no verification step or fallback if the path is absent — a minor validation gap matching anchor 4.

4 / 5

Progressive Disclosure

The reference to `~/.agents/skills/boris/SKILL.md` is one level deep and clearly signaled, but the entire skill content lives outside the bundle (no references/, scripts/, or assets/ directories exist), so nothing is placed within the skill itself. That is a larger organization gap than anchor 4's 'minor organization gaps', fitting anchor 3's 'could be better organized' despite the clearly signaled pointer.

3 / 5

Total

15

/

20

Passed

Description

70%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 well-constructed description with an explicit 'Use when...' clause and a strong, natural trigger-term list tied to a clearly identified niche. Its main weakness is the vague capability statement — 'tips' — which leaves the 'what' under-specified and holds specificity and completeness below the top anchors.

Suggestions

Replace the generic 'Codex workflow tips' with one or two concrete actions, e.g. 'Applies Boris Cherny's recommended Codex configurations and workflow patterns' or 'Diagnoses and optimizes Codex agent workflows'.

Add natural trigger variations such as 'Codex CLI', 'configuring Codex', or 'Codex setup' to broaden keyword coverage for users who don't say 'setting up'.

Narrow overlapping terms (e.g. 'hooks', 'MCP', 'permissions') with Codex-specific phrasing like 'Codex sandboxing' to reduce conflict risk with general agent-workflow skills.

DimensionReasoningScore

Specificity

The description names the domain ("Codex workflow tips") and enumerates nine concrete topics ("parallel sessions, worktrees, plan mode, AGENTS.md, skills, subagents, hooks, MCP, permissions, and sandboxing"), but the only capability verb is the generic "tips" — it never states what the skill actually does with those topics. This sits between anchor 2 ("Names the domain but actions are minimal or generic") and anchor 3, and the broad topic list keeps it at 3 rather than 2.

3 / 5

Completeness

Both parts are present: the what ("Codex workflow tips from Boris Cherny and the Codex team") and an explicit when ("Use when setting up Codex or optimizing workflows: ...") with concrete trigger topics. It is not a 5 because the 'what' relies on the vague word 'tips' rather than concrete actions, fitting anchor 4's 'when' could be more explicit or specific' level rather than the fully concrete anchor 5 example.

4 / 5

Trigger Term Quality

"Use when setting up Codex or optimizing workflows" plus the topic list gives good natural keyword coverage ("parallel sessions", "worktrees", "plan mode", "AGENTS.md", "hooks", "MCP", "sandboxing") that users would plausibly say. It falls short of anchor 5 because common synonyms and variations (e.g., "Codex CLI", "configuring Codex", "codex setup") are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — "Boris Cherny and the Codex team", "AGENTS.md", "setting up Codex" — making it mostly distinct with minimal confusion against non-Codex skills. It is not a 5 because generic trigger terms like "skills", "subagents", "hooks", "MCP", and "permissions" overlap with general agent-workflow skills, matching anchor 4's 'minor overlap risk with closely related skills'.

4 / 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: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/harness/adapters/antigravity/skills/boris/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.