Content
38%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.
The body lays out a recognizable NOS assessment workflow with some concrete script commands, but it is weighed down by generic templated boilerplate and, more seriously, depends on reference and script files that are not bundled. The missing bundle files break both actionability and progressive disclosure, and the inlined boilerplate hurts conciseness.
Suggestions
Ship the referenced bundle files (`references/nos_criteria_prompts.md`, `scripts/extract_pdf.py`, `scripts/format_nos_table.py`) or remove the references — pointing Claude at non-existent files breaks the workflow mid-execution.
Cut the generic boilerplate sections (When to Use, Key Features restating the description, Recommended Workflow, Output Contract, Validation and Safety Rules, Failure Handling) down to NOS-specific guidance; Claude already knows generic skill hygiene.
Inline the actual NOS Selection/Comparability/Exposure criteria (or ensure the reference file exists and is clearly linked) so the evaluation step is actionable without relying on a missing file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is noticeably verbose with several padded, generic boilerplate sections ('Use this skill when the request matches its documented task boundary', 'Prefer this skill for repeatable, checklist-driven execution rather than open-ended brainstorming', the Key Features block restating the description, and 'See ## Usage above for related details'), matching the 'noticeably verbose; several unnecessary explanations or padded sections' anchor; it is not a 1 because there is some genuinely useful NOS-specific content. | 2 / 5 |
Actionability | It gives a few concrete commands (`python scripts/extract_pdf.py --help`, `python scripts/format_nos_table.py '<json_string>'`) but the substantive NOS evaluation criteria are delegated to `references/nos_criteria_prompts.md`, which is not bundled, so key executable detail is missing — matching the 'some concrete guidance but incomplete; missing key details' anchor. | 3 / 5 |
Workflow Clarity | A sequenced workflow exists (Extract Metadata -> Evaluate Criteria -> Synthesize -> Format Output, plus Steps 1-4) with generic validation framing, but the checkpoints are implicit and the core evaluation step depends on a missing reference file, fitting the 'steps listed but validation gaps; checkpoints missing or implicit' anchor rather than the explicit-checkpoint anchor 4. | 3 / 5 |
Progressive Disclosure | The body signals references to `references/nos_criteria_prompts.md`, `scripts/extract_pdf.py`, and `scripts/format_nos_table.py`, but none of these bundle files actually exist (no references/, scripts/, or assets/ directories), so the navigation points to missing material while generic content is inlined — matching the 'minimal structure; references buried/broken' band and falling below anchor 3 where references would at least be real. | 2 / 5 |
Total | 10 / 20 Passed |