Content
90%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exemplary architecture/routing skill: lean, path-precise, and immediately actionable, with a sound progressive-disclosure shape (overview here, hard constraints in AGENTS.md, dialog spec in DESIGN.md). The main gap is operational: the referenced DESIGN.md is missing from the bundle, so the normative dialog self-check cannot actually be walked.
Suggestions
Include DESIGN.md in the skill bundle (the body calls it normative and requires walking its self-check list before submitting); without it the dialog rules are unenforceable.
Add a brief fix-and-retry note to the 'Before you submit' section (what to do when lint/format/test or the CI guards flag a change) to close the workflow's feedback loop.
Mention the TUI abbreviation (or a synonym) in the frontmatter description so users who say 'TUI' rather than 'terminal UI' still trigger the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, decision-routing bullets with exact paths and identifiers ('components/messages/tool-renderers/registry.ts', 'buildSkillSlashCommands', 'saveTuiConfig', 'mountEditorReplacement') and no explanation of concepts Claude already knows. Every token earns its place — matches the lean/efficient 5 anchor rather than 4. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: a feature-type routing table with exact landing files, named functions for the theme apply/switch flow, and hard rules ('a component never writes the config file itself', 'do not stack branches inside ToolCallComponent'). No missing key details, so it fits the fully-executable 5 anchor rather than the minor-gaps 4. | 5 / 5 |
Workflow Clarity | Clear sequence — read apps/kimi-code/AGENTS.md first, route the feature, then the 'Before you submit' checklist (lint/format/test, walk the DESIGN.md self-check, keep printableChar()/chalk.hex guards). Validation for the riskiest area (dialogs) is deferred to an external checklist and no fix-and-retry loop is described, so it matches 'most checkpoints present; minor validation gaps' (4) rather than the explicit-feedback-loop 5 anchor. | 4 / 5 |
Progressive Disclosure | Well-sectioned overview with clearly signaled one-level-deep references (apps/kimi-code/AGENTS.md, ./DESIGN.md), fitting 'good structure; references mostly clear; minor organization gaps'. It falls short of 5 because the normative ./DESIGN.md it relies on is not present in the skill's bundle, leaving the primary detailed reference dangling. | 4 / 5 |
Total | 18 / 20 Passed |