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.
A well-crafted, instruction-only skill body: lean prose, a numbered workflow with real checkpoints, a closing quality-gate checklist, and appropriately externalized detail. The only gap is that key artifacts (probe library, improvement template) are referenced but not included, leaving minor execution dependencies on files outside this bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries operational weight — 'Probes read data; they don't free-associate', 'count name frequency — the 80/20 read', 'An improvement we can't revert or falsify is a mandate, not a bet' — with zero explanation of concepts Claude already knows. Even the aphoristic lines encode rules compactly rather than padding. | 5 / 5 |
Actionability | Concrete, executable guidance throughout: named inputs ('board.md, flow-log.csv, recent reviews/, learnings/, topology.md, and the cards' dependencies: fields'), named outputs ('improvements/<slug>/improvement.md', 'reviews/YYYY-MM-DD-improve-probe.md'), and specified table columns ('% work localized / change size / risk / future-proofness'). Not a 5 because the actual probe definitions and the improvement template live in external files not shown here, and step 5's 'compose your spec-writing skills' is a high-level hint rather than a specific instruction. | 4 / 5 |
Workflow Clarity | A clearly sequenced 6-step workflow (load library → gather data → run probes → capture bets → right-size ceremony → report) with embedded checkpoints in step 3 ('signal present? cite the data. No signal? one "checked, quiet" line') and an explicit Quality Gates checklist closing the loop ('Every probe run is accounted for', 'Zero direct edits to pdlc.md / topology.md / tiers in this invocation'). Not a 4 because validation is explicit and checklist-form, not merely implicit. | 5 / 5 |
Progressive Disclosure | The body is a concise overview that keeps probe definitions external ('skills/portfolio-pdlc/references/probe-library.md'), referenced one level deep and clearly signaled both in workflow step 1 and in a dedicated References section with a one-line description of each target. Not a 4 because there is no inline content that belongs in a separate file and no organization gaps — navigation is trivial. | 5 / 5 |
Total | 19 / 20 Passed |