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 content is a model instruction-only skill: dense project-specific contracts, executable validation commands at every gate, an explicit error-recovery loop, and clean one-level-deep references to the owning files. It neither pads with known concepts nor omits key details, and it clearly separates content synchronization from deployment concerns.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence throughout: no explanation of what VitePress, Markdown, or manifests are — only project-specific contracts ('Never edit or commit website/.generated/', 'foo.zh.md projects to the root route') and commands. Every token earns its place. | 5 / 5 |
Actionability | Guidance is fully executable: copy-paste commands (pnpm docs:dev, pnpm docs:check, pnpm run doc-sync, pnpm run lint, git diff --check), explicit per-field DocsPage guidance (source, route, label, sidebar, section, order, sourceAliases) with pairedPages()/mirroredPages() usage rules, and a concrete change-classification table covering the common cases. | 5 / 5 |
Workflow Clarity | A clear sequence (read owning contracts → classify the change → set manifest fields → preserve link behavior → preview and validate) with explicit validation gates ('Run the focused website gate before treating the mapping as valid') and a feedback loop for error recovery ('If Markdown link checks pass but the site build reports a missing fragment, follow the verify-doc-site-fragments source and target paths'). Destructive rename/remove operations are handled atomically with docs:check rejecting stale entries. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the ~87-line body is appropriately self-contained: all external material (docs/AGENTS.md, sibling skills dsh-doc-standards and dsh-pre-push-checks, website/docs.ts, .vitepress/config.ts, docs/i18n/README.md) is referenced via clearly signaled one-level-deep links with explicit 'read before changing' contracts, making navigation easy. | 5 / 5 |
Total | 20 / 20 Passed |