Content
78%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 compact, well-structured diagnostic skill with concrete, executable codesign/spctl/plutil commands and a clear workflow. Removing the command-list duplication and adding a small aid for the classification step would tighten it further.
Suggestions
Collapse the standalone "Useful Commands" list into the workflow steps (or keep only the two commands not already shown there, e.g. `security find-identity`) to remove duplication.
Add a one-line command or decision hint next to each "Classify the failure" entry (e.g. how to detect ad-hoc vs. wrong identity) so the classification step is as actionable as the inspection step.
Add an explicit validation checkpoint such as re-running `codesign -dv --verify` or `spctl -a -vv` after the proposed fix to confirm the failure class is resolved.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (no explaining what codesigning is), but the "Useful Commands" section repeats `codesign -dvvv` and `spctl -a -vv` already given in the workflow, a minor trim opportunity. | 4 / 5 |
Actionability | It gives copy-paste-ready commands (`codesign -dvvv --entitlements :- <path>`, `spctl -a -vv <path>`, `plutil -p`, `security find-identity -p codesigning -v`), but the "Classify the failure" step lists failure classes without an accompanying command or decision aid, leaving a minor gap. | 4 / 5 |
Workflow Clarity | A clear four-step sequence (Inspect → Read signing details → Classify → Explain fix) is present; reading signing details acts as implicit validation for this read-only diagnostic skill, though no explicit verify/retry checkpoint is stated. | 4 / 5 |
Progressive Disclosure | Under 50 lines with no bundle files and no need for external references, the content is well-organized into clear sections (Quick Start, Workflow, Useful Commands, Guardrails, Output Expectations), satisfying the simple-skill exception for a top score. | 5 / 5 |
Total | 17 / 20 Passed |