Content
75%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 well-organized, actionable operational skill with clearly sequenced modes and meaningful safety checkpoints. The main improvement opportunity is closing the destructive-operation validation loop by verifying the archive before clearing the live wiki.
Suggestions
Before clearing the live wiki (Mode 2 Step 2 / Mode 3 Step 4), add a validation checkpoint: verify the fresh archive's page count against archive-meta.json's total_pages (or compare file counts) and only proceed when the archive is confirmed intact.
Remove the redundant opening line duplicating Safety Rules 1-2, or trim the Safety Rules section to only the rules not already stated up front.
Show the 'empty template' for index.md inline (or point to where it is defined) so the reset step in Mode 2 Step 2 is fully executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and procedural with no explanations of concepts Claude already knows; the only trimmable redundancy is the opening line 'Always archive first, always confirm with the user before proceeding', which duplicates Safety Rules 1 and 2 at the end. | 4 / 5 |
Actionability | Guidance is mostly executable: exact archive paths, a concrete archive-meta.json schema, exact log-entry formats, and copy-paste commands like '${QMD_CLI:-qmd} update'. Minor gaps: the archive copy step has no explicit command, and 'Reset index.md to the empty template' never shows the template. | 4 / 5 |
Workflow Clarity | All three modes are clearly sequenced with real checkpoints — user confirmation before clearing, a mandatory pre-restore archive, QMD verification via 'ls'/'get', and a post-restore 'wiki-lint' suggestion. It falls short of 5 because the most critical validation is missing: nothing verifies the archive is complete before the live wiki is wiped. | 4 / 5 |
Progressive Disclosure | A single well-sectioned file with clear headers, one clearly signaled external reference (llm-wiki/SKILL.md), and a legitimately shared inline QMD section. The QMD refresh details are a plausible candidate for a separate reference file, keeping this at 'good structure; minor organization gaps'. | 4 / 5 |
Total | 16 / 20 Passed |