Content
86%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 skill body: copy-paste-ready CLI and pytest guidance, current version-specific flag information placed appropriately, and clean separation of deep CI/auth wiring into a single verified one-level-deep reference. The only improvement area is trimming the redundancy between 'How to use', 'Install', and 'Running via CLI'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly token-efficient (tables of flags, checks, and anti-patterns carry operational info Claude would not know, e.g. the 3.x flag deprecations), but the Install section and the basic 'schemathesis run <schema-url>' invocation repeat steps already given in 'How to use'. Efficient with minor instances that could be trimmed, matching the 4 anchor. | 4 / 5 |
Actionability | Fully executable throughout: a copy-paste-ready worked CLI example with flags and auth header, a complete runnable pytest snippet ('@schema.parametrize()' + 'case.call_and_validate()'), concrete check names, and an anti-patterns table with specific fixes. Matches the 5 anchor; the <schema-url> placeholders are inherent, not gaps. | 5 / 5 |
Workflow Clarity | The 'How to use' section gives a clear 4-step sequence with validation checkpoints (reproduce failures from the printed curl command + Hypothesis seed, triage every shrunk failure, always target staging), and the CI section defines per-PR/nightly cadence. It sits between 4 and 5: most checkpoints are present but the failure-triage error-recovery loop and full CI workflow are delegated to the reference file rather than explicit inline, so 4. | 4 / 5 |
Progressive Disclosure | SKILL.md is a clear overview and the advanced material (GitHub Actions workflow, cadence table, before_call auth hooks) is split into exactly one well-signaled, one-level-deep file (references/ci-and-pytest-integration.md), which exists and contains real content with no nested references. Each of the three inline pointers describes what lives in the reference, matching the 5 anchor. | 5 / 5 |
Total | 18 / 20 Passed |