Content
100%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 instruction-style skill body: everything is repo-specific and non-obvious, commands are copy-paste ready, the workflow embeds validation with explicit failure-handling loops, and bundle content is cleanly partitioned with all referenced files present. No changes needed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence throughout: rule ids with one-line summaries, the exact output format "SEV<TAB>RULE<TAB>path:line<TAB>snippet", exit-code semantics, and config gotchas — no filler and no explanation of concepts Claude already knows. Even the maintainer and known-limitations sections are dense, non-inferable facts that earn their tokens. | 5 / 5 |
Actionability | Fully executable guidance: three copy-paste-ready gate invocations ("uv run python .agents/skills/kiln-conventions/scripts/conventions_gate.py --worktree" etc.), the allowlist procedure with a reason-line format, and a concrete FAIL/WARN decision tree with an example justification. The self-check section converts each rule id into a checkable condition. | 5 / 5 |
Workflow Clarity | A clear five-step sequence (read rules → read per-area references → write → run gate → self-check) where the gate is an explicit validation checkpoint, with feedback loops for error recovery (FAIL → fix and re-run; unfixable → report with rule id, path:line and the refactor it waits on) and a checklist for what the gate cannot see. The reviewer and maintainer workflows are separately sequenced. | 5 / 5 |
Progressive Disclosure | The overview stays in SKILL.md while bulk content is split one level deep and verified to exist: rules in references/rules.md, per-area facts selected via a path→reference table (core.md, server_desktop.md, web_ui.md), and the gate plus its tests, config and allowlist under scripts/. The only external pointer (kiln-ui) is another skill, appropriately referenced rather than duplicated. | 5 / 5 |
Total | 20 / 20 Passed |