CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-factory-router

Review Codex skill-management intent to select its downstream owner. Use when the owner is ambiguous or the user explicitly asks for routing, not when a downstream lane is already clear.

Quality

84%

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 highly actionable router skill: the routing table, output schema, failure modes, and validation commands are concrete and executable, and references are well-structured with explicit load conditions. The main weakness is redundancy — the execution-boundary and route-is-not-proof rules are each stated several times across Gotchas, Execution Boundaries, and Validation, which could be consolidated.

Suggestions

Merge the Gotchas and Execution Boundaries sections into a single boundaries section; both state that the router only selects the lane and that downstream skills own edits, sync, evals, install proof, and publication proof.

Deduplicate the rule that a route decision is not proof of install/eval/visibility, which appears in both Gotchas (line 92) and Validation (line 114), keeping it once in Validation.

Move the Anti-Patterns list into references/routing-policy.md alongside the other policy handles so the body stays a lean routing overview.

DimensionReasoningScore

Conciseness

The body avoids explaining known concepts but repeats the downstream-ownership boundary roughly five times across Outputs ("Downstream lanes own review reports, eval artifacts, package outputs, runtime evidence, commits, and publication receipts"), Workflow step 9, Gotchas, the Execution Boundaries section, and Validation; "a route decision ... is not proof that a skill is installed, visible in Codex, passing evals" also appears twice. This is more than minor trimming, matching anchor 3 ("could be tightened") rather than anchor 4.

3 / 5

Actionability

The skill provides a copy-paste-ready YAML handoff template with explicit enums (selected_lane, mode, first_principles_check result), a numbered routing table covering create, capture, harden, analyze, refactor, install, and fork-block requests, exact reference paths, and verbatim validation commands ("bash Infrastructure/scripts/validation-and-linting/validate_skill_authoring_family.sh", "./bin/ask skills external-review ... --audit-level compat --json"). This fully matches anchor 5 for an instruction-only skill.

5 / 5

Workflow Clarity

The workflow is a clearly sequenced 9-step decision procedure with a precedence rule ("Explicit lane names win unless the user names multiple lanes or asks for an unsafe action"), a Failure Mode section covering blocked-state recovery, and explicit validation steps ("Stop at the first failed required gate ... do not sync, commit, publish, or install until it is fixed or explicitly blocked"). The router is read-only, so the destructive/batch validation cap does not apply; this matches anchor 5.

5 / 5

Progressive Disclosure

All five referenced files exist in references/ (contract.yaml, evals.yaml, task-profile.json, discovery-interview.md, routing-policy.md), are one level deep, and each is gated by a precise "Read when" condition, with the instruction "Load only the reference needed for the selected routing question". Policy detail is correctly deferred to references (routing-policy.md defers further to source handles), matching anchor 5.

5 / 5

Total

18

/

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 well-structured description with an excellent explicit when-clause (including a negative boundary) and strong distinctiveness, held back by jargon-leaning trigger terms and a thin enumeration of concrete actions. Third-person voice is used correctly and there is no fluff.

Suggestions

Add natural trigger phrases users would actually say, such as "which lane owns this skill request" or "route this to the right skill factory lane", to complement the condition-based when-clause.

Name one or two more concrete outcomes in the what, e.g. "returns a YAML routing handoff naming the selected lane, mode, and next step", to lift specificity from anchor 3 to anchor 4.

Replace one instance of internal jargon ("downstream lane"/"downstream owner") with user-facing vocabulary so the description triggers on the words users naturally use.

DimensionReasoningScore

Specificity

"Review Codex skill-management intent to select its downstream owner" names the domain and one to two concrete actions (review intent, select owner) but does not enumerate the full set of actions or the handoff output it returns. This matches anchor 3 rather than 4, which expects several specific listed actions.

3 / 5

Completeness

The what is clear ("Review Codex skill-management intent to select its downstream owner") and the when is explicit with three concrete conditions including a negative boundary ("Use when the owner is ambiguous or the user explicitly asks for routing, not when a downstream lane is already clear"). Both are clearly and explicitly answered, matching anchor 5 rather than anchor 4, whose when-clause "could be more explicit or specific" does not apply here.

5 / 5

Trigger Term Quality

Relevant keywords like "skill", "routing", and "owner is ambiguous" are present, but the phrasing leans on internal jargon ("downstream lane", "downstream owner") and misses natural user variations such as "which lane owns this" or "route this skill request". Anchor 3 (some relevant keywords, missing common variations) is the best fit.

3 / 5

Distinctiveness Conflict Risk

The description carves out a narrow niche (Codex skill-management routing) and its exclusion clause ("not when a downstream lane is already clear") actively prevents firing when an execution lane is already determined. This is a clear niche with distinct triggers and minimal conflict risk, matching anchor 5.

5 / 5

Total

16

/

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

Plugins/skill-factory/skills/skill-factory-router/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.