Content
92%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 well-structured, highly actionable command-discovery and routing guide with explicit validation feedback loops and clean progressive disclosure into verified reference files. The only dimension short of the top anchor is conciseness, where a few dense Schema-boundary sections could be trimmed or moved deeper.
Suggestions
Tighten the 'Schema、Help 与业务数据的边界' and 'Helper-only 与本地 Cobra 命令' sections or move their detail into a dedicated reference file to reduce token load while keeping the boundary rules inline as a short checklist.
Consider collapsing the repeated guidance about --compact / --all / full-leaf behavior into a single short table since the same caveat appears across several sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and focused on command/contract semantics (Schema progressive query, --compact field whitelist, confirmation protocol) with little padding of concepts Claude already knows. It does not fully reach the lean 5 anchor because sections like 'Schema、Help 与业务数据的边界' and the helper-only discussion are lengthy and could be tightened or pushed deeper into references. | 4 / 5 |
Actionability | It provides fully executable, copy-paste-ready commands (`dws schema`, `dws schema "calendar event create" --compact`, `--format json`, `--dry-run`, `--verbose`) plus a worked JSON leaf example and concrete decision-tree branches, matching the 'fully executable; specific examples cover the common cases' anchor. | 5 / 5 |
Workflow Clarity | The core flow is a clearly sequenced four-step process with a URL-precheck step 0, plus an explicit destructive-operation confirmation protocol (summary → user consent → --yes) and a confirmation_required retry/feedback loop, matching the 'clear sequence with explicit validation steps; feedback loops for error recovery' anchor. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear overview pointing to one-level-deep references (products/, intent-guide.md, url-patterns.md, best_practices/, scripts/) with every referenced file verified to exist, and large detail (aitable sub-chapters) is appropriately split into separate files, matching the 'clear overview with well-signaled one-level-deep references' anchor. | 5 / 5 |
Total | 19 / 20 Passed |