Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a sound progressive-disclosure structure pointing to real reference files, but it is verbose — the Resources section and the five Typical Workflows duplicate content already in Core Capabilities. Batch workflows also lack inline validation checkpoints.
Suggestions
Remove the 'Resources' section (or collapse it to one line per file): it duplicates the reference bullet lists already given in each 'Core Capabilities' subsection.
Trim 'Typical Workflows' to two representative examples and point to the reference files for the rest, cutting roughly 150 lines of repeated code.
Add an inline validation/verification step to the multi-slide batch workflow (Workflow 4) — e.g. confirm tile count per slide and wrap extraction in try/except with logging — so batch operations have a real feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly informative but padded: the 'Resources' section repeats the reference bullet lists already given in 'Core Capabilities', and the five 'Typical Workflows' largely re-state the inline examples, so the body could be tightened considerably. Not a 1 because the code examples are concrete and there is little concept-explanation fluff. | 2 / 3 |
Actionability | Provides numerous complete, executable code blocks with real imports, concrete parameters (tile_size, level, seed, tissue_percent) and full call sequences — copy-paste ready, matching the top anchor. | 3 / 3 |
Workflow Clarity | Workflows are sequenced and include a 'preview before extracting' checkpoint, but batch operations (Workflow 4's multi-slide loop) lack validation/verification steps and error-recovery checkpoints are isolated in a separate Troubleshooting section rather than inline. Per the batch-operations rule this caps the score at 2. | 2 / 3 |
Progressive Disclosure | The SKILL.md is an overview with five well-signaled, one-level-deep references (slide_management, tissue_masks, tile_extraction, filters_preprocessing, visualization), all verified to exist in references/ — clear navigation and appropriate content split. | 3 / 3 |
Total | 10 / 12 Passed |