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 well-crafted analysis skill body: tight, highly actionable, with a clean sequenced workflow and a concrete output schema. Its main weakness is progressive disclosure — the body points to template and example files that are not present in the bundle, leaving the reader to navigate to files that do not resolve.
Suggestions
Ship the referenced bundle files (template.md, examples/sample.md, examples/sample-industrial.md) or remove the links so navigation does not dead-end.
Inline one short validate-fix-retry checkpoint in the Application steps rather than relying entirely on the autonomous-investigation protocol reference, so the workflow is self-contained.
Trim the editorial asides (e.g. "a rating without signals is vibes", "not a diagram for slide four") to tighten the body further without losing the substance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (a one-line 1979 framing, no padding about what a 'force' is), but editorial flair like "a rating without signals is vibes" and "not a diagram for slide four" could be trimmed without losing guidance. | 4 / 5 |
Actionability | For an instruction-only workflow skill it is fully actionable: a numbered procedure, a copy-paste output schema with per-field labels, explicit Final Step options, and a worked buyer-power example showing the exact signal-plus-label format. | 5 / 5 |
Workflow Clarity | The sequence is clear — credit context → 3-bullet search-plan gate → rate forces → emit schema → 4-option close — with implicit validation via Fact/Inference/Assumption labels and the "how do you know?" test, but explicit validate-then-fix checkpoints are delegated to the referenced protocol rather than stated inline. | 4 / 5 |
Progressive Disclosure | Structure and one-level-deep references (template.md, examples/sample.md, examples/sample-industrial.md) are clearly signaled, but none of the referenced bundle files exist on disk, so the promised navigation leads nowhere and the inlined schema/examples carry load that the missing files were meant to share. | 3 / 5 |
Total | 16 / 20 Passed |