Content
35%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 is dominated by generic one-size-fits-all template sections that carry almost no skill-specific information, and its few concrete claims are wrong for the bundled script (no `--help` flag, no result file — the script prints JSON with a count and titles). The structural skeleton is passable, but the content neither teaches the actual usage nor survives verification against `scripts/search_pubmed.py`.
Suggestions
Replace the templated sections (When to Use, Required Inputs, Output Contract, Validation and Safety Rules, etc.) with skill-specific guidance: show the real invocation `python scripts/search_pubmed.py "your search query"` and document that it prints `{"total": <count>, "text": <titles>}` and silently returns `{"total": 0, "text": ""}` on network failure.
Fix the Quick Validation section: the script has no `--help` flag (no argparse) and writes no `search_pubmed_result.md` file, so the current command and expected-output format are both incorrect.
Fix the broken reference in "## scripts" ("see [scripts/search_pubmed.py].") to a proper markdown link like `see [scripts/search_pubmed.py](scripts/search_pubmed.py)`, and remove the "Description" section that duplicates the frontmatter.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly two-thirds of the body is generic template boilerplate that applies to any skill ("Use this skill when the request matches its documented task boundary", "Validate the request against the skill boundary and confirm all required inputs are present"), plus a "Description" section that duplicates the frontmatter. It is not score 1 because it never explains domain concepts Claude already knows; it is not score 3 because the padding is pervasive across nine sections, not a minor instance. | 2 / 5 |
Actionability | Concrete elements exist (script path `scripts/search_pubmed.py`, `python -m py_compile scripts/search_pubmed.py`), but the actual execution step is never shown — no example like `python scripts/search_pubmed.py "aspirin AND stroke"`, no documentation that the query is passed as argv[1]. Worse, the documented `python scripts/search_pubmed.py --help` is wrong (the script has no argparse and would treat `--help` as a search query), and the "Expected output format" ("Result file: search_pubmed_result.md...") is fabricated — the script prints `{"total": ..., "text": ...}` to stdout and writes no file. It is not score 3 because the key specifics to execute are missing and the documented commands contradict the script; it is not score 1 because real file paths and one working command are given. | 2 / 5 |
Workflow Clarity | A sequenced "Recommended Workflow" (4 steps) and a "Quick Validation" section provide a sequence and an attempted checkpoint, but the steps are generic template text and the validation checkpoint is factually wrong for this script (no `--help` flag, no result file — it prints JSON). It is not score 4 because the checkpoints are not concrete, correct commands tied to steps; it is not score 2 because a sequence is clearly present and validation is attempted rather than absent. | 3 / 5 |
Progressive Disclosure | The body is organized into sections and points to the real bundle file `scripts/search_pubmed.py` (verified to exist), but the pointer in "## scripts" is a bare bracket reference ("see [scripts/search_pubmed.py].") with no link target, the "Description" section duplicates the frontmatter, and the "## scripts" heading is lowercase and disorganized. It is not score 4 because references are not clearly signaled and organization gaps are visible; it is not score 2 because the structure is reasonable and the bundle file is genuinely referenced. | 3 / 5 |
Total | 10 / 20 Passed |