Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-structured body with excellent progressive disclosure and executable examples throughout. Its main weaknesses are length/redundancy around version verification and the absence of explicit validation feedback loops in batch/download workflows.
Suggestions
Consolidate the version-verification guidance into one location (e.g., Installation) and reference it elsewhere, removing the repeated upgrade snippets in Overview and Best Practices to tighten conciseness.
Add an explicit validate→fix→retry feedback loop to the batch download workflow (e.g., verify each batch's file count/integrity before proceeding to the next, and retry failed series).
Consider moving the full inline index/join tables into references/index_tables_guide.md, keeping only the most-used tables inline with a pointer, to reduce SKILL.md length while preserving the strong navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, concrete, and free of basic-concept filler, but at ~850 lines it repeats version-verification guidance in three places (Overview, Installation, Best Practices) and could be tightened; it is not score 3 because not every token earns its place, and not score 1 because it avoids explaining concepts Claude already knows. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready Python, SQL, and bash examples throughout (sql_query, download_from_selection, get_viewer_URL, idc CLI, manifest generation), matching the score-3 anchor of concrete executable guidance with specific examples. | 3 / 3 |
Workflow Clarity | Steps are sequenced (core workflow 1-2-3, explore-then-query, version-check-first) with some checkpoints, but batch and bulk-download operations lack explicit validate→fix→retry feedback loops; per the rubric, missing validation in batch/destructive operations caps this at 2 rather than 3. | 2 / 3 |
Progressive Disclosure | A Quick Navigation section lists inline core sections plus a 'Reference Guides' table with a 'When to Load' column, and all 10 references/ files exist and are one level deep with clear 'See references/X.md for...' signals, matching the score-3 anchor of well-signaled one-level-deep references with easy navigation. | 3 / 3 |
Total | 10 / 12 Passed |