CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

eval-agents

Audit custom subagent definitions for Claude Code (.claude/agents/*.md) and Codex (.codex/agents/*.toml): loadability against the native schema, description overlap, model tier, tool scope, and headless-safe instructions. Use when onboarding to a project with agents, after adding or importing agents, or when the parent agent delegates to the wrong agent.

Quality

87%

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

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.

The skill is highly actionable with an exemplary step/checkpoint workflow, but it is a monolithic single file: the host-reference lookup tables should live in references/ files, and version-locked details (CLI version gates, model pricing) bloat the token budget and will age. Strengths are execution guidance and validation; weaknesses are conciseness and file structure.

Suggestions

Move the Claude Code and Codex host-reference sections (load precedence, frontmatter field table, Codex key table) into references/ files (e.g. references/claude-code.md, references/codex.md) and keep SKILL.md as an overview with clearly signaled one-level-deep links.

Trim time-sensitive specifics from the main flow — the v2.1.233 version gates and the Opus/Haiku per-million-token prices — or consolidate them into a single clearly marked version-sensitive note so they can be maintained in one place.

Shorten the illustrative audit report in Step 6 to the table skeleton only, cutting the fully worked per-agent example to reduce tokens without losing the format contract.

DimensionReasoningScore

Conciseness

The body is dense and factual (runtime skip rules, field tables, precedence), but includes unquarantined time-sensitive specifics — "v2.1.233 or later" (twice) and Opus 5.5 at $4/$20 / Haiku 5.5 at $0.10/$0.50 pricing — plus a long illustrative report block that could be trimmed. Mostly efficient yet noticeably tighten-able, so it sits at 3 rather than 4, and well above the padding of 2.

3 / 5

Actionability

Provides copy-paste-ready commands (find -L .claude/agents -name "*.md", claude plugin validate .claude/agents, ctxharness doctor --format json), point-allocated scoring tables, and a complete report template. Fully executable guidance covering the common cases, matching the 5 anchor rather than the 4 anchor's "minor gaps".

5 / 5

Workflow Clarity

Six clearly sequenced steps each end in an explicit "Done when:" checkpoint, with loadability validation in Step 2 (claude plugin validate), score thresholds in Step 4, and destructive deletion gated behind an explicit "yes, remove it" confirmation. This matches the 5 anchor (explicit validation steps, feedback loops, checklists); the 4 anchor's "minor validation gaps" does not apply.

5 / 5

Progressive Disclosure

No bundle files exist and everything is inline in one ~250-line SKILL.md; the ~95-line host reference (load precedence, 18-field frontmatter table, Codex table) is reference material that belongs in a references/ file. In-file structure is good (clear headers and tables), so this is 3 ("content that should be separate is inline") rather than 2, but not 4 since no content is split out.

3 / 5

Total

16

/

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.

The description is a strong example: it names concrete capabilities with host-specific file patterns, gives an explicit 'Use when' clause with three realistic triggers, and occupies a distinct niche. The only weakness is slightly incomplete natural-keyword synonym coverage.

DimensionReasoningScore

Specificity

Lists five concrete audit checks ("loadability against the native schema, description overlap, model tier, tool scope, and headless-safe instructions") plus concrete file patterns (.claude/agents/*.md, .codex/agents/*.toml), comprehensively covering the audit's dimensions. It exceeds the 4 anchor because coverage shows no minor gaps.

5 / 5

Completeness

Explicitly answers both: what ("Audit custom subagent definitions ... loadability, description overlap, model tier, tool scope, and headless-safe instructions") and when ("Use when onboarding to a project with agents, after adding or importing agents, or when the parent agent delegates to the wrong agent") with concrete trigger phrases. The 4 anchor's caveat ("'when' could be more explicit") does not apply.

5 / 5

Trigger Term Quality

Natural user-voiced triggers like "onboarding to a project with agents", "after adding or importing agents", and "delegates to the wrong agent" are present, but common variants such as "agent fleet" or "review my agents" are missing. Good coverage but not the comprehensive synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche (custom subagent definitions for two named hosts with specific paths) with distinct triggers; the body further separates sibling skills (eval-skills, eval-hooks, eval-rules). Minimal conflict risk, matching the 5 anchor rather than the 4 anchor's "minor overlap risk".

5 / 5

Total

19

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

FlorianBruniaux/claude-code-ultimate-guide

Path

examples/skills/eval-agents/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.