Content
88%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 unusually disciplined operational skill: concrete commands with enforced validation and feedback loops at every write, a clear mode gate, and real one-level-deep references for quota, network, and delivery detail. The main costs are density in the long decision-rule sections and reliance on cross-skill files that live outside this bundle.
Suggestions
Move the full postdoc-table and employment-type-label sub-policies (decision rules 6 and 9) into a reference file (e.g. references/postdoc.md, references/labels.md), keeping only the one-line decision rule in SKILL.md.
Tighten the multi-clause run-on sentences in the Procedure and decision rules into short imperative bullets so each rule can be checked at a glance.
Either vendor the needed content from jobradar's hosts.md / record-schema.md into this skill's references, or state clearly at first link that these files belong to the sibling jobradar skill so navigation failures are self-explanatory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | There is no padding that explains concepts Claude already knows — nearly every sentence carries a non-obvious domain rule, so it sits above the level-3 'could be tightened' anchor. However, sections like decision rule 6 (postdoc handling) and rule 9 (employment-type labels) are long nested run-ons whose detail could be trimmed or pushed to a reference, matching level 4's 'minor instances that could be trimmed' rather than level 5's 'every token earns its place'. | 4 / 5 |
Actionability | Fully executable guidance: concrete commands for every step ("$P preflight --mode <mode> --host <codex|opencode|claude-code|deepseek|other>", "$P snapshot --label start", "$P apply --delta delta.json", "$P closeout"), a copy-paste delta JSON example covering update/create/views/move, a mode table with explicit Allowed/Never columns, and exact field names (核查缺口, 限额处理, application_tracking, system/state/watchlist.json). This matches the level-5 anchor; the elided {…} field payloads are templates for dynamic data, not pseudocode, so it does not fall to level 4. | 5 / 5 |
Workflow Clarity | The procedure is a numbered 1–5 sequence with explicit validation checkpoints at every stage: snapshot after every preflight, "Then $P validate --snapshot <path>", apply that 'simulates it (refusing new validation errors)', and closeout whose receipt must be quoted with failures reported as "not complete". Feedback loops are explicit ("If it refuses, change the delta or ask the user; never bypass it"), and the report template acts as a closing checklist — matching the level-5 anchor exactly. | 5 / 5 |
Progressive Disclosure | Good structure: the three local references (quota.md, network.md, delivery.md) all exist, are one level deep, and are clearly signaled with markdown links at the point of need, and the scripts directory is referenced appropriately. It falls short of level 5 because the main file is a 194-line operating manual rather than an overview — decision rules 6 and 9 in particular carry reference-level detail inline — and several links point outside the bundle to the sibling skill ("../jobradar/references/hosts.md", jobradar "record-schema.md"), which do not resolve within this skill's directory. | 4 / 5 |
Total | 18 / 20 Passed |