Content
92%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 exemplary operational skill body: lean, safety-first, with a fully sequenced workflow of validation checkpoints and feedback loops, an explicit output contract, and minimal verifiable evidence of success. The only shortcoming is that the apply invocation is not spelled out as a complete command.
Suggestions
Include the full apply command verbatim (e.g., 'python3 scripts/sync_skills.py --destination "<destination>" --profile core --apply') alongside the check command so step 5 is copy-paste ready.
Briefly state where scripts/validate_repo.py and sync_skills.py come from (source repo layout) so a reader can locate them without inference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~50-line body is lean and sectioned (适用范围/工作流程/安全边界/输出契约/验证) with zero padding or explanation of concepts Claude already knows; every line adds operational or safety information, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Concrete, near copy-paste commands are given for validation ('python3 scripts/validate_repo.py --strict') and the read-only check ('python3 scripts/sync_skills.py --destination "<destination>" --profile core --check'), plus a concrete destination example ('C:\Users\<user>\.codex\skills'), but the apply step is described rather than given verbatim and the referenced scripts live in the source repo rather than the bundle — minor gaps that keep it at 4 rather than 5. | 4 / 5 |
Workflow Clarity | The 5-step sequence is explicit with validation checkpoints at every risky point: strict source validation before anything, a read-only --check baseline, user-confirmed apply, and a mandatory post-apply --check on the same destination; failure handling ('源端校验失败时停止恢复并保留原始错误') and the verification evidence block complete the feedback loop, satisfying the destructive/batch validation requirement rather than falling under its cap. | 5 / 5 |
Progressive Disclosure | The body is short, well-organized, and delegates the cross-device checklist to a single clearly signaled one-level-deep reference ([restore-profile.md](references/restore-profile.md)) that actually exists in the bundle with no further nesting — the ideal overview-plus-one-reference structure. | 5 / 5 |
Total | 19 / 20 Passed |