Content
63%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 dense, actionable reference with clear per-scenario recovery workflows and executable curl/Python examples; its main weaknesses are token bloat from the inlined Python class and the absence of progressive disclosure via separate reference files for the CDX API and implementation detail.
Suggestions
Move the full Python implementation into a references/ file (e.g. references/recovery.py) and keep only a minimal usage snippet in SKILL.md to cut ~120 lines of inline code that duplicates the curl examples.
Extract the CDX API parameter table and response-format detail into a references/cdx-api.md, signaling it with a one-level-deep 'See [cdx-api.md]' link so SKILL.md reads as an overview.
Add an explicit verify checkpoint to each Investigation Pattern (e.g. 'Confirm statuscode:200 and a non-empty digest before constructing the archive URL') to turn the implicit validation into a clear feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient reference material (URL tables, CDX params, curl examples) that assumes Claude's competence, but the ~120-line Python class largely duplicates the curl examples and includes a hand-wavy 'simplified - would need HTML parsing' comment; a few transitional sentences ('Understanding GitHub's URL structure is essential...') could be trimmed. | 3 / 5 |
Actionability | Copy-paste-ready curl commands, full URL-pattern tables, a working Python class with a usage example, and per-scenario command sequences; minor gaps remain in placeholder substitution ({TIMESTAMP}/{owner}/{repo}) and the simplified fork-extraction regex. | 4 / 5 |
Workflow Clarity | Investigation Patterns give clear Step 1/2/3 sequences with concrete commands for file, issue/PR, fork, and wiki recovery; this is read-only OSINT (no destructive/batch cap applies) and includes light validation (filter=statuscode:200, HTTP code check for forks), though explicit verify-then-continue feedback loops are only implicit. | 4 / 5 |
Progressive Disclosure | Well-sectioned body, but no bundle files exist and the bulk CDX API reference and full Python implementation are inlined in a ~400-line SKILL.md rather than split into one-level-deep reference files; the only external links are the 'Learn More' pointers. | 3 / 5 |
Total | 14 / 20 Passed |