Content
92%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 process-oriented skill body: numbered workflow, copy-paste-ready gate commands with output format and exit-code semantics, explicit feedback loops for FAIL/WARN handling, a self-check checklist for review-only rules, and clean conditional loading of one-level-deep references keyed by edited paths. The only notable trim opportunity is the maintainer-focused "Maintaining the gate" section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no explanations of uv, pytest, or general concepts; every gate rule is referenced by id rather than restated). It falls short of the 5 anchor because the ~20-line "Maintaining the gate" section — config notes, glob syntax, pytest invocation — serves a maintainer rather than a code-change audience and could be trimmed or moved to a reference; it is noticeably above the 3 anchor since the rest is lean and padded nowhere. | 4 / 5 |
Actionability | Guidance is fully executable: three copy-paste-ready invocations of the gate (``uv run python .agents/skills/kiln-conventions/scripts/conventions_gate.py --worktree`` / ``--range`` / ``--files``), the exact output format (``SEV<TAB>RULE<TAB>path:line<TAB>snippet``), exit-code semantics, per-severity handling instructions, and a concrete example WARN justification. It matches the 5 anchor (copy-paste ready commands covering the common cases). | 5 / 5 |
Workflow Clarity | A clear 5-step sequence with explicit validation (step 4 runs the gate on the change; exit 1 means a FAIL), feedback loops for error recovery (fix and re-run, allowlist with a reason line, or report an unfixable FAIL with rule id and path:line), and a checklist for what the gate cannot see (step 5's rule-by-rule self-check), plus a separate reviewer workflow. This matches the 5 anchor's "explicit validation steps; feedback loops; checklists". | 5 / 5 |
Progressive Disclosure | The body is a workflow overview with well-signaled, one-level-deep references: a path-to-reference table tells the agent to read only ``references/rules.md`` plus the per-area file matching the edited paths (all four reference files and all cited scripts exist, and every rule id cited in the body is defined in rules.md). Content is appropriately split between SKILL.md, references, and scripts, and navigation is easy; the inline maintainer section is clearly labeled and too minor to drop this to the 4 anchor. | 5 / 5 |
Total | 19 / 20 Passed |