Content
86%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.
A tight, well-structured body that carries all stage rules, agent behaviors, and the template convention in minimal tokens. Its two gaps are executable specificity — template names left as placeholders and promote/publish mechanics left implicit — and the absence of an explicit review checkpoint before shipping.
Suggestions
List the available template names (e.g. idea, draft, published) in the Templates section instead of the bare `<name>` placeholder so template selection is fully executable.
Spell out the promote and publish mechanics — the exact write/move operation and which frontmatter fields to set or clear at each stage transition (idea → draft, draft → published).
Add a brief checklist for drafts in `status: review` (what to verify before shipping) to close the workflow's only checkpoint gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | At ~24 lines the body is pure rules: an ASCII flow diagram, per-folder rules with specific thresholds ("idle more than 30 days", "idle more than 14 days") and named frontmatter fields, and a one-line template convention. Nothing explains concepts Claude already knows and every token earns its place, matching the 'lean and efficient' anchor rather than 4, which would require some over-explanation to trim. | 5 / 5 |
Actionability | Mostly executable guidance: concrete frontmatter fields (`status: drafting/review`, `published_at`, `canonical_url`, `channel`), a concrete path pattern (`drafts/<slug>/research/`), and a real call shape (`write({ document: { path, template: "<name>" } })`). It stops short of 5 because the template name is a placeholder with no enumerated template list, and the promote/publish mechanics (which write/move operation, which fields to set at each transition) are implied rather than given. | 4 / 5 |
Workflow Clarity | The three-stage sequence is clearly laid out (ideas → "commit to writing it" → drafts → "ship" → published) with per-stage rules and an immutability guardrail ("Treat as immutable; to revise, copy to a new draft"). Not 5 because there are no explicit validation/review checkpoints — the `status: review` stage is named but what to check before shipping is never specified — though this is prose work rather than a destructive/batch operation, so the 3-cap for missing validation does not apply. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files and no need for external references, and the simple-skill exception applies: the sections (flow diagram, per-folder rules, Templates) are well-organized and the one external pointer (the platform `/open-knowledge` skill) is clearly signaled and one level deep. No content that belongs in a separate file is inlined, so neither the 4 nor the 3 anchor fits better. | 5 / 5 |
Total | 18 / 20 Passed |