Content
77%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-structured, guardrail-heavy instruction skill with deterministic thresholds, explicit preflight/postflight validation, failure-mode recovery loops, and a clean one-level-deep bundle where every referenced file exists and is clearly signaled. The main weaknesses are the repeated restatement of the same structural constraint across many sections and the unspecified 0/1/2 sub-scores within the real-person scoring matrix.
Suggestions
Consolidate the 4-roles / 4-rounds / 7-sections / 4-turns-per-round constraint into a single canonical Output Contract section and reference it from the composition, profiles, and end-of-file sections instead of restating it 6-7 times.
Define what earns 0, 1, or 2 on each Real-Person Scoring Matrix dimension (e.g., Domain relevance: 0 = no public work in domain, 1 = adjacent work, 2 = direct public work) so the >= 5/6 gate is deterministic across runs.
Move the candidate selection criteria details (evidence anchors, examples of decision-pressure diversity) into a reference file and keep only the pass thresholds inline to reduce SKILL.md token weight.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with no concept-teaching padding, but the same structural constraint is restated many times: "Keep exactly 4 dialogue rounds and 7 output sections" appears in Fixed Four-Lens Composition, Output Contract Guardrail ("Always produce exactly 7 sections... 16 turns total"), the preflight checklist, Controlled Execution Profiles ("must not change 4 roles, 4 rounds, or 7 sections"), Required Output Sections ("Do not skip section 1 or any dialogue round"), and Output Contract ("If using `lean` profile, keep all required sections and all four role turns per round"). Fits anchor 3 ('mostly efficient but... could be tightened'); not 4 because the repetition is more than a minor instance. | 3 / 5 |
Actionability | Highly executable deterministic guidance: numeric gates ("Real Person A score >= 5/6", "Pair diversity score >= 2/2", "confidence in pair quality is below 0.6"), a deterministic 4-step fallback order, the exact 7-section output list, FM1-FM5 failure modes with recovery actions, and a runnable lint script ("scripts/lint_response.ps1 for hard-gate structure checks"). Not 5 because the scoring matrix never defines what earns 0 vs 1 vs 2 on each per-person dimension, and there is no inline worked example of a dialogue turn (all examples live in referenced files). | 4 / 5 |
Workflow Clarity | The 6-step Workflow is clearly sequenced with sub-bullets, and validation is explicit throughout: preflight and postflight checklists, step 6 "Run guardrail self-check", a scoring-matrix gate before finalizing the roster, failure-mode recovery actions (e.g., "rerank candidates using the scoring matrix; replace weakest candidate"), and a regression protocol ("Run at least 5 cases from eval-cases.md", "Track rubric score before/after edits and avoid regressions"). Matches anchor 5: clear sequence, explicit validation, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | All referenced paths exist and are one level deep, each with a clearly signaled purpose: references/eval-rubric.md "for scoring criteria", references/eval-cases.md "for regression test prompts", scripts/lint_response.ps1 "for hard-gate structure checks on generated outputs", references/output-templates.md "for English output", references/output-templates-zh.md "for Chinese output". Core operating rules stay inline in SKILL.md while templates and eval material are appropriately split out; matches anchor 5. | 5 / 5 |
Total | 17 / 20 Passed |