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.
A strong, genuinely operational protocol skill: concrete contract schemas, bounded-read levels, single-writer ownership, a structured BLOCKED gate, and a pre-dispatch checklist make it highly actionable with a clear sequenced workflow. Its weaknesses are repetition of the same incident statistics and dated anecdotes (conciseness), a few unbound parameters like K and N where concrete defaults exist elsewhere, and a monolithic ~310-line body that should push plugin specs, the Workflow contract, and case tables into reference files — leaving one bundle script entirely unreferenced.
Suggestions
Move the P1/P2 plugin specs, the section-13 Workflow contract, and the reverse-case table into references/ files (e.g., references/plugins.md, references/workflow-contract.md) and link them one level deep; also reference scripts/workflow_preflight_router.py from the body so the full bundle is discoverable.
State the repeated incident evidence (204,869 token / cache=0 stat, b21b9211 anecdote) once in a single 'origin session' section instead of three times across sections 9 and 10, and trim dated narrative padding like the 2026-08-25 log.
Replace unbound placeholders ("最多 N 个额外文件", "连续 K 个有效动作窗口") with concrete default numbers, matching the style already used in section 8's budgets.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient, operational content (contract templates, state machine, budget numbers) with no padding on basics Claude already knows, but it includes repeated war-story detail: the "单步 204,869 输入 token / cache=0" statistic is stated three times (sections 9 and 10 areas), the b21b9211 anecdote appears twice, and there is narrative incident padding ("2026-08-25 实测…用户两次发火") plus a large ASCII box that could be a bullet list. Tightening these would move it to anchor 4; it is not anchor 2 because the bulk of the body is genuinely non-obvious operational protocol. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: the contract snapshot field template (GOAL/OWN/MAY READ/OUT OF SCOPE/…), the structured BLOCKED schema with an invalidity gate, Level 0-2 read permissions with reason codes, a 7-item pre-dispatch checklist, and runnable script invocations ("session-discipline-audit.js <session id|zstd 路径>", Node ≥22 requirement). Not score 5 because some thresholds are left as unbound symbols ("最多 N 个额外文件", "连续 K 个有效动作窗口" — K is never given a number, unlike section 8's concrete budgets) and the plugin sections describe behavior without any usage or install instructions. | 4 / 5 |
Workflow Clarity | The multi-step process is clearly sequenced: role separation (Discovery → Contract → Implementation → Validation), contract construction, dispatch with the 12-section pre-flight checklist, state-machine reporting, and a failure/recovery path (repair contract instead of full re-dispatch, persisted task-state files). Validation checkpoints are explicit (DONE requires validation evidence, BLOCKED invalidity gate, STALLED watchdog criteria). Not score 5 because validation of the overall outcome is scattered across sections rather than one closed loop, and some transitions (e.g., who runs the discipline audit and when) are implied rather than stated. | 4 / 5 |
Progressive Disclosure | Section headers are clear and the two referenced scripts are real, one level deep, and signaled with usage syntax — but the SKILL.md is a ~310-line monolith that inlines content clearly suited to separate reference files (the P1/P2 plugin specifications, the 13-section Workflow orchestration contract, the reverse-case table, the model routing table), with no references/ split at all. Additionally, scripts/workflow_preflight_router.py exists in the bundle but is never referenced from the body, making part of the bundle undiscoverable. This matches anchor 3: structure present, but content that should be separate is inline. | 3 / 5 |
Total | 14 / 20 Passed |