Content
93%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.
An exemplary lean, single-purpose skill body: executable commands, explicit input/output contracts, pre-handled failure modes, and well-signaled one-level-deep references. The only weakness is that the post-launch verification step (matching MAP_VAULT to the intended vault) is implicit rather than an explicit checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with operational facts — vault resolution ("PATENT_READER_OBSIDIAN_VAULT 或 ~/.patent-disclosure-skill/obsidian_vault.txt"), the glob "Research/Patents/**/*_解读_*.md", machine-readable prefixes (MAP_URL/MAP_PORT/MAP_VAULT…), model name, and a graceful fallback ("未装 fastembed 时图仍能开，地形退回 IPC 簇") — with no concept explanations Claude already knows. Matches anchor 5 ('lean and efficient; every token earns its place'); not 4 because there is no over-explanation to trim. | 5 / 5 |
Actionability | Copy-paste-ready commands ("python skills/patent-map/tools/serve_map.py", "pip install -r skills/patent-map/tools/requirements.txt", "python tools/serve_map.py") plus a concrete output contract (machine-readable stdout prefixes, random port on 127.0.0.1:0) and failure-mode handling. Matches anchor 5 ('fully executable; copy-paste ready commands; specific examples cover the common cases'); not 4 because even the standalone-copy path and the no-fastembed path are covered. | 5 / 5 |
Workflow Clarity | A clear 3-step sequence (Read prompts/guardrails.md → intake.md; 确认库路径; 启动) with implicit checkpoints — path confirmation and the machine-readable startup prefixes. Matches anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'); not 5 because there is no explicit step verifying MAP_VAULT matches the intended vault before sharing the URL, and not 3 because the sequence and its checkpoints are unambiguous (the skill is read-only, so the destructive/batch validation cap does not apply). | 4 / 5 |
Progressive Disclosure | Under 50 lines, single task, cleanly sectioned (用途/何时用/输入/步骤/护栏/产出物) with one-level-deep, clearly signaled references ("细则 prompts/guardrails.md", "Read prompts/guardrails.md → intake.md"). Per the simple-skill scoring note this matches anchor 5; not 4 because no organizational gaps remain. | 5 / 5 |
Total | 19 / 20 Passed |