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 highly actionable, well-sectioned body whose commands and APIs check out against the real scripts, weakened by significant command duplication across sections and a monolithic structure that inlines reference-grade material. The three commands referencing examples/*.json are broken as shipped since those files are missing from the bundle.
Suggestions
Deduplicate the body: remove the '# Version'/'# Dependencies' sections (frontmatter already carries them), merge 'Recommended Workflow' with 'Commands Reference' (init/config/quick_setup are shown twice), and fold 'Core Capabilities' bullets into the actual sections — this should cut the body roughly in half.
Move the DuckDB SQL function reference, the five template JSON schemas, and the Python API walkthrough into reference files (e.g. references/sql-functions.md, references/templates.md) and link them one level deep.
Ship the referenced examples/training_examples.json and examples/diverse_training_examples.json in an examples/ directory, or remove the three commands that depend on them so no documented command fails as written.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — it teaches no concepts Claude already knows — but a 570-line body carries real duplication: '# Version' / '# Dependencies' sections restate the frontmatter, 'Core Capabilities' bullets restate the later sections, init/config/quick_setup commands appear nearly verbatim in both 'Recommended Workflow' and 'Commands Reference', and SQL examples repeat between Quick Start and Common Operations. This lands on 'mostly efficient but could be tightened' rather than score 2, since the padding is redundant-but-accurate commands rather than concept explanations. | 3 / 5 |
Actionability | Nearly all guidance is copy-paste ready and verifiable against the actual bundle — the documented uv run commands, CLI subcommands (query/describe/sample/count/histogram/unique/transform/export/raw), and the Python API (HFDatasetSQL.query/describe/sample/count/histogram/filter_and_transform/push_to_hub/export_to_parquet) all exist in scripts/sql_manager.py and scripts/dataset_manager.py. The gap from score 5: three commands depend on examples/training_examples.json and examples/diverse_training_examples.json, which are not present in the bundle, so those commands fail as written. | 4 / 5 |
Workflow Clarity | The recommended workflow is clearly sequenced (Discovery via MCP → Creation → Content Management), combined-workflow examples are numbered, and there are genuine checkpoints: an 'Error Handling' section, a note that 'add_rows and quick_setup return a nonzero exit status if validation or an upload fails, so automation should check their exit status', and JSON validation on upload. It falls short of score 5 because no explicit validate → fix → retry feedback loop is spelled out for the batch add_rows/push operations. | 4 / 5 |
Progressive Disclosure | Section headers are clear and the two scripts are appropriately externalized, but bulky reference material — the DuckDB SQL function reference, five JSON template schemas, the HF path format spec, and the Python API walkthrough — is inlined in one 570-line body where a leaner SKILL.md would point to reference files. Additionally, references to examples/*.json files are dangling (the files do not exist in the bundle), which is a navigation defect. Scored against the actual bundle structure, this is 'some structure but content that should be separate is inline' with imperfectly reliable references. | 3 / 5 |
Total | 14 / 20 Passed |