Content
63%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 well-structured with executable CLI commands and a clear workflow, but it has two concrete integrity problems: the referenced `templates/` directory is absent from the bundle (breaking `init`), and `references/wiki-flavors.md` is never signaled from the body. The speculative auto-research section with version numbers also spends tokens on future functionality.
Suggestions
Add the `templates/` directory (wiki.config.md, index.md, sources.md, maintenance-log.md, prompts/) to the bundle, or remove the "See templates/" section — as bundled, `init_wiki.sh` cannot run because its template source directory does not exist.
Link `references/wiki-flavors.md` from the Flavors section (e.g., "Per-flavor folder layouts: see [wiki-flavors.md](references/wiki-flavors.md)") so the existing reference file is discoverable instead of orphaned.
Move the "Auto-research opt-in" section (Phase 3.3.0/3.3.1 version talk and a YAML block for a not-yet-shipped feature) out of SKILL.md into a reference file, restoring token efficiency and removing time-sensitive version numbers from the main body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — the Locations, Layout, CLI surface, and Quality bar sections are tight and earn their tokens — but the "Auto-research opt-in" section spends ~10 lines on a feature that "Phase 3.3.0 ships builder + query only. Loop arrives in 3.3.1", i.e. time-sensitive version-anchored content about a capability that does not exist yet, which the guidelines penalize. Not 4 because that speculative block plus the version numbers are clear padding; not 2 because the rest of the body is lean with no explanations of concepts Claude already knows. | 3 / 5 |
Actionability | The CLI surface gives fully executable commands ("node $SKILL_ROOT/scripts/wiki-cli.js init <slug> --title 'X' --flavor research [--scope project]"), the layout tree is concrete, and the workflow references real operations. Not 5 because "See `templates/`" points at a directory that does not exist in the bundle (init_wiki.sh copies from $skill_dir/templates, so `init` cannot actually run as bundled), and compile-page guidance is deferred to prompt files that are also only in the missing templates/. Not 3 because the commands that are present are copy-paste ready. | 4 / 5 |
Workflow Clarity | The "Workflow when invoked" section gives a clear 6-step sequence (resolve action → read wiki.config.md → cite sources.md rows → call wiki-cli.js page to sync FTS → append maintenance-log entry → update index.md), with the FTS re-index acting as a sync checkpoint. Not 5 because there is no validation or error-recovery step (e.g., what to do when a citation is missing or the CLI write fails) for what is a batch-write operation; not 3 because the sequence is explicit, ordered, and each step names its artifact. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: the body references `scripts/wiki-cli.js` and `init_wiki.sh` (both real), but "See `templates/` for wiki.config.md, index.md, prompt files" is a dangling reference — no templates/ directory exists in the bundle — and `references/wiki-flavors.md` (109 lines of per-flavor layouts) is never linked from the body at all, so the reference is buried and the inline Flavors table partially duplicates its role. Not 4 because one reference is broken and one bundle file is undiscoverable; not 2 because the body itself is well-sectioned and short with most content appropriately placed. | 3 / 5 |
Total | 14 / 20 Passed |