Route plugin-factory requests to the right lane. Use when plugin creation, building, installation, review, or routing is broad, mixed, or under-specified.
49
53%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./Plugins/plugin-factory/skills/plugin-factory-router/SKILL.mdQuality
Discovery
57%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description functions as a meta-routing skill for plugin-related tasks, which is a valid use case, but it suffers from vague language about what it actually does ('route to the right lane' is unclear). The 'Use when' clause is present and lists trigger conditions, but the internal jargon ('plugin-factory', 'lane') reduces clarity. The description would benefit from explaining what routing means in practice and what outcomes the user can expect.
Suggestions
Replace vague language like 'route to the right lane' with concrete actions, e.g., 'Triages plugin-related requests and delegates to the appropriate specialized skill for creation, building, installation, or review.'
Clarify internal jargon: explain what 'plugin-factory' and 'lane' mean in user-facing terms so the description is self-contained and understandable.
Add examples of what 'broad, mixed, or under-specified' requests look like to help Claude better distinguish when to select this routing skill versus a specific plugin skill.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'route requests to the right lane' without listing concrete actions. It doesn't explain what specific operations are performed—'routing' is abstract and 'plugin-factory requests' is jargon without clarification. | 1 / 3 |
Completeness | It does answer both 'what' (routes plugin-factory requests to the right lane) and 'when' (when plugin creation, building, installation, review, or routing is broad, mixed, or under-specified) with an explicit 'Use when' clause containing trigger conditions. | 3 / 3 |
Trigger Term Quality | It includes some relevant keywords like 'plugin creation', 'building', 'installation', 'review', and 'routing', which users might naturally say. However, the terms 'plugin-factory' and 'lane' are internal jargon that users wouldn't typically use, and common variations are missing. | 2 / 3 |
Distinctiveness Conflict Risk | The description positions itself as a router/dispatcher for plugin-related tasks, which gives it a somewhat distinct role. However, terms like 'plugin creation' and 'building' could easily overlap with the actual skills that handle those specific tasks, creating potential conflict. | 2 / 3 |
Total | 8 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a routing/orchestration skill that clearly defines its read-only scope and failure modes, which is a strength. However, it suffers from redundant safety statements across multiple sections and lacks concrete examples of actual routing decisions (input → structured output). The core workflow logic is deferred to an unreachable reference file, making the skill incomplete as a standalone document.
Suggestions
Add a concrete example showing a sample user request and the exact structured routing output (lane selected, rationale, next command) to improve actionability.
Consolidate the overlapping safety constraints from 'Execution Boundaries', 'Constraints', 'Gotchas', and 'Anti-Patterns' into a single section to reduce redundancy and improve conciseness.
Inline a simplified routing decision tree or flowchart in the skill body rather than deferring entirely to references/workflow.md, so the skill is actionable even without the bundle.
Remove or shorten the 'First-Principles Gate' section—its abstract framing (copied assumption, smallest effective mechanism, proof needed) would benefit from a concrete before/after example or should be moved to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes some redundancy—execution boundaries, constraints, gotchas, and anti-patterns overlap significantly (e.g., 'do not install or execute plugin code' is stated in at least three places). The 'First-Principles Gate' and 'Plugin design checkpoint' sections add conceptual weight without concrete examples of how to apply them. | 2 / 3 |
Actionability | The skill provides structured guidance on what to do (route to a lane, return a rationale, return a next command) but lacks concrete executable examples—no sample input/output showing what a routing decision actually looks like in practice. The examples section lists natural-language prompts but never shows the expected structured output or decision format. | 2 / 3 |
Workflow Clarity | The workflow is partially clear: there's a logical sequence (receive request → check inputs → select lane → hand off) and failure modes are addressed. However, the actual routing decision tree is deferred to references/workflow.md which is not provided, and there are no explicit validation checkpoints within the routing workflow itself beyond a bash script at the end that applies to authoring, not routing. | 2 / 3 |
Progressive Disclosure | References are clearly listed and one-level deep, which is good. However, no bundle files are provided to verify the references exist, and the main body contains substantial inline content (design contract details, context-disposition policy) that could be in referenced files. The 'Read when' section is a good pattern but the overall split between inline and referenced content is uneven. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
Total | 10 / 11 Passed | |
d00c351
Table of Contents
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.