Content
93%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 lean skill body: project-specific conventions delivered in a dense table, copy-paste-ready git and gh commands, and a clearly sequenced delivery workflow. The only gap is the absence of an explicit post-PR validation checkpoint, which keeps workflow clarity at 4.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~35-line body uses a dense conventions table and assumes Claude's competence throughout, explaining nothing Claude already knows. The one justification offered ("an inline `--body` breaks on backticks and quotes in zsh") is earned, non-obvious project knowledge, so every token earns its place — matching the anchor-5 lean example. | 5 / 5 |
Actionability | Commands are copy-paste ready: `git push -u origin <branch>` and the full heredoc plus `GH_PAGER=cat gh pr create ... --body-file` block, alongside concrete branch-naming taxonomy, commit format with a worked example ("TAS-42: Fix token refresh"), and PR title format. This matches anchor 5's fully executable, common-case-covering guidance. | 5 / 5 |
Workflow Clarity | The numbered Deliver sequence (commit → push → open PR → link from tracker, with the "Do not merge it" guardrail) is clear and command-backed, fitting anchor 4's clear sequence with minor validation gaps. It is not 5 because there is no explicit checkpoint (e.g., confirm the PR opened or CI passed before linking), though the non-destructive workflow means the destructive-operation cap does not apply. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no external bundle files needed, and its sections (conventions table, Deliver, The tracker) are well organized. The tracker-config pointer (`.opencastle/project/<tracker>-config.md` and the task-management skill slot) is one level deep and clearly signaled, so under the rubric's simple-skill note it merits 5. | 5 / 5 |
Total | 19 / 20 Passed |