Content
73%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 well-engineered, highly actionable sub-agent spec: the workflow phases, refusal machinery, and exact output schema are exemplary, with validation and feedback loops throughout. The main costs are redundancy (refusal rules repeated across three sections) and one under-specified executable detail (the sha256 hash placeholder).
Suggestions
Consolidate the refusal rules into a single authoritative section (the 禁止读取 table) and have Phase 0 and the Refusals section reference it by name instead of restating the paths and reasons.
Give the exact command for the script_hash field (e.g., sha256sum <script-path> | cut -c1-12) so the JSON output is fully copy-paste reproducible.
Move the main-Claude call-contract template and refusal-code reference into a small one-level-deep reference file (e.g., references/call-contract.md) to slim the SKILL.md body and improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly high-value, non-inferable content (channel model, hard-refusal table, known limitations), but refusal rules are stated three times — the '禁止读取' table, the Phase 0 '不要做的事' list, and the 'Refusals' section — and the contamination grep pattern appears twice (body self-check and main-Claude call check). This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' better than 'minor instances'. | 3 / 5 |
Actionability | Concrete and largely executable: a fully filled JSON output example, exact grep regexes (e.g., grep -E '\d+\s*[wWmMkK万]|播放|实绩|实际'), enumerated refusal codes, a copy-paste Task prompt contract, and a parseability check via python3 -c "import json; json.loads(...)". Not 5: 'script_hash': '<sha256:12 of script content>' gives no command for computing the hash, a minor executable gap. | 4 / 5 |
Workflow Clarity | Phases 0-3 are clearly sequenced with explicit validation checkpoints: whitelist path validation in Phase 0, a mandatory post-read contamination grep with a defined degradation rule (confidence dropped to medium, refusal set to non_blind_warning, snippet captured), refusal codes for every failure mode, a strict JSON-parseability requirement, and a re-prompt feedback loop for the main Claude's call contract. This matches the anchor with explicit validation steps, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ absent), so everything lives in one ~205-line SKILL.md; it is well organized with clear section headers, tables, and a worked example. Not 5: the call-contract template and refusal-code reference are inline content that could plausibly sit in a separate one-level-deep reference file, and at this length the single-file structure is adequate rather than exemplary. | 4 / 5 |
Total | 16 / 20 Passed |