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.
The body is a tightly written, fully executable workflow: every step carries an exact command or a precise decision rule, an explicit validation loop (writing-check) gates the send, and edge cases (shell-injection via pnpm, backticks/$ in titles, the 2,000-character limit, duplicate sends) are each handled concretely. No bundle files exist or are needed for a skill of this size.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~23-line body is lean with no explanations of concepts Claude already knows; every clause is operational (e.g., "because pnpm hands its arguments to `sh` inside double quotes, so each backticked span or `$` in the text runs as a command" is a load-bearing safety rationale, not padding). It matches anchor 5 (every token earns its place) rather than anchor 4, since trimming any clause would lose actionable content. | 5 / 5 |
Actionability | Steps give exact executable commands ("node tooling/scripts/notify.mjs send --to <login or dev> \"$(cat <file>)\"", "gh issue view <N> --repo <owner/repo> --json title -q .title", "node .agents/pstack/writing-check.mjs <file>"), an exact link format, and handling for every common case including edge cases (off-team recipient, `skipped:` output, 2000-character split, unpushed commit hashes). Per the rubric's code-vs-instruction note, this instruction-only skill's guidance is fully concrete, matching anchor 5. | 5 / 5 |
Workflow Clarity | A clear five-step sequence (pick recipient, draft, validate, send, report) with an explicit validate-and-fix feedback loop in step 3 ("Run `node .agents/pstack/writing-check.mjs <file>` and fix each line it prints") before the send, plus failure handling in step 1 ("stop and say so") and step 5 ("When the command prints `skipped:`, say so"). This matches anchor 5's explicit validation with error-recovery feedback loops; the destructive/batch cap does not apply since this is a single non-destructive send with validation present. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, and has no bundle files; per the rubric's simple-skills note it qualifies for a 5 with well-organized sections, which the numbered steps provide. Detail is correctly delegated one level deep to clearly signaled project files (`.agents/pstack/rules/writing.md`, `.agents/pstack.json`, `tooling/scripts/notify.mjs`) with only the key rules inlined. | 5 / 5 |
Total | 20 / 20 Passed |