Content
75%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.
This is a strong, highly actionable skill body with an executable command, clear tables, explicit validation pitfalls, and a well-organized one-level-deep bundle. Its main weakness is token efficiency: duplicated caveat prose and full dual-format output examples (with a hard-coded date) could be tightened or moved to a reference file.
Suggestions
Consolidate the two overlapping caveat paragraphs (regime-report degradation and theme-detector ingestion) into one terse degradation-rules block, or move them into references/exposure_framework.md.
Trim the Output Format section to one compact example (or a field-description table) instead of full JSON and markdown blocks, and remove the hard-coded generation date from the example.
Promote the post-run check of `inputs_provided`/`inputs_missing` into a numbered Step 3 item (e.g. "Validate: confirm no supplied input appears in `inputs_missing`; if it does, report the dimension degraded") so the feedback loop is structural rather than prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient (tables, a complete command, terse principles), but the two long inline caveat paragraphs on regime-report degradation and theme-detector ingestion are repetitive of each other, and the full JSON plus markdown output examples (including a hard-coded date, "2026-03-16T07:00:00Z") inflate the token budget; the degradation rules belong in a reference file. | 3 / 5 |
Actionability | The body provides a fully executable, copy-paste-ready bash invocation with all eight input flags and an output directory, a concrete file-pattern table per upstream skill, explicit recommendation-to-action mappings, and exact output filenames — the common case is completely covered. | 5 / 5 |
Workflow Clarity | The four-step workflow is clearly sequenced and includes an explicit post-run validation checkpoint ("inspect the generated JSON fields `inputs_provided` and `inputs_missing`... report the affected dimension as degraded and keep confidence capped") with error-recovery guidance; however, this validation lives in embedded prose rather than a numbered step with a fix-and-retry loop, so it falls just short of the anchor above. | 4 / 5 |
Progressive Disclosure | The Resources section clearly signals the script and both reference files, all of which exist in the bundle and are only one level deep (no nested references inside them), and the threshold/mapping detail is appropriately split out of SKILL.md; minor gaps remain in that the output-format examples and ingestion caveats are inlined rather than referenced. | 4 / 5 |
Total | 16 / 20 Passed |