Content
71%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 dense, sophisticated instruction-only skill with an explicitly ordered execution pipeline, field-level schemas, validation checkpoints, and failure-handling paths — its actionability and workflow are strong for a protocol skill. Its structural weakness is that it depends on a constellation of external files (generated.md, governance.yaml, adapters) that are not bundled, so the SKILL.md cannot stand alone, and its schema detail is inlined rather than split into references.
Suggestions
Bundle or inline the content of the referenced authority files (instruction/generated.md §1/§3/§5/§6, governance.yaml revision rules) — or strip the citations — since none of them ship with the skill and the protocol cannot be followed without them.
Move the field-level schema definitions (episode schema, prediction schema, current.yaml entry fields) into a references/ file (e.g. references/schemas.md), keeping SKILL.md as the overview with one-level-deep, well-signaled links.
Add a minimal worked example of one loop iteration (prediction → action → observation → evaluation → ledger append) so the abstract pipeline is grounded in a concrete trace.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and information-rich — nearly every line carries protocol specifics (schemas, step gates, file layouts) with no concept explanations Claude already knows, matching anchor 4's 'efficient; minor instances of over-explanation'. The trims that would reach anchor 5 are the design-rationale asides: the note on why invariant counts are not written ("不写条数:条数会随规范件演进而漂"), the blockquote distinguishing the plugin-side config.mode from session self-determination, and the '世界模型不是记忆库' framing sentence. | 4 / 5 |
Actionability | For an instruction-only skill, guidance is concrete: exact file paths (ledger/YYYY-MM-DD.jsonl, runs/<session-id>.jsonl, current.yaml), full field-level schemas (event_id, prediction_id, falsifier, time_horizon...), parseable time_horizon formats ("2026-10-15T12:00:00Z", "+30m/+12h/+3d/+2w"), an 11-step named pipeline, and mechanical tool-risk tiers. It falls short of anchor 5 because the executing machinery it cites — the adapters (mind/distill.py, mind/lp_evaluator.py), the governance/proposal path, and the guard implementation — is external and unspecified in the bundle, leaving gaps in how key steps actually execute. | 4 / 5 |
Workflow Clarity | The 执行时序 section gives a strictly ordered 11-step sequence ("顺序即验收" — order is acceptance) with explicit validation checkpoints (PREDICTION_EVALUATED confirmed/refuted/partial; guards refuse consequential actions without a bound prediction) and feedback loops (failed prediction → residual label + one of three explicit revision paths), plus a session-end checklist. It does not reach anchor 5 because part of the authoritative sequencing is delegated to instruction/generated.md §6, which is not in the bundle, leaving ambiguity about which form governs. | 4 / 5 |
Progressive Disclosure | Sections are clearly headed and well-ordered (模式, 不变量, 状态层, 执行时序, 各环要点, Canonical 写入门槛, 会话结束契约), but the skill ships no bundle files at all, while the body references many external files that are not in the bundle (instruction/generated.md §1/§3/§5/§6, governance.yaml, dsh/world-model/cordis.patch.yml, mind/distill.py, mind/lp_evaluator.py, proposals/) — dangling navigation targets. Additionally, ~50 lines of inline schema/field definitions (状态层 block, episode and prediction schemas) are content that would typically live in a reference file. This fits anchor 3: structure present, references clearly named but unusable, and reference-type content inlined; not anchor 2 since structure and signaling are real, not 'minimal' or 'buried'. | 3 / 5 |
Total | 15 / 20 Passed |