Content
87%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.
The body is lean, highly actionable, and well-structured, with concrete commands and a clear decision table. The only meaningful weakness is the absence of validation/verification for a destructive batch write, which caps workflow clarity.
Suggestions
Add an explicit validation checkpoint after profile-write (e.g., re-run `home-profile list --target both` to confirm the candidate was removed and the formal entry is correct), which would lift workflow_clarity above the 3 cap.
Provide full example ops JSON for `merge` and `replace` (not only `add`) so every branch of the decision table is copy-paste ready, removing the small inference gap.
Add a brief dry-run or guard for the batch case (e.g., review all ops in the `--ops` array before submitting) to match the batching note with a concrete verification step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and table-driven — purpose line, a 3-step list, a compact decision table, one bash example, and short criteria/notes — with no padding and no explanation of concepts Claude already knows, matching the 'lean and efficient; every token earns its place' anchor. | 5 / 5 |
Actionability | It provides executable commands (`miloco-cli home-profile list --target both`, `profile-write --ops '...'`), a copy-paste-ready JSON ops example, and a decision table mapping each relationship to a concrete op with required parameters, covering the common cases. | 5 / 5 |
Workflow Clarity | The sequence (list ready_to_promote → analyze relationship → profile-write) is clear and the decision table is explicit, but profile-write is a destructive batch operation that auto-deletes candidates and can replace entries, and there is no validation/verification checkpoint; the rubric caps such skills at 3. | 3 / 5 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, and uses no external references, but is well-organized into clear section headers (执行步骤, 提升决策, 矛盾裁决参考, 注意), satisfying the simple-skill exception for a 5. | 5 / 5 |
Total | 18 / 20 Passed |