Content
88%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.
An exceptionally actionable and well-checkpointed operational skill: every step carries exact commands, thresholds, and error-recovery rules, and batch operations are guarded by explicit validation. The only notable gaps are duplicated guidance across sections (conciseness) and two referenced prompt files missing from the bundle (progressive disclosure).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and skill-specific with no concept padding (cost table, gotchas like "No `from __future__ import annotations` in UDF modules"), but guidance is repeated across sections — the access-check rule appears in Critical Rule 5, Step 1.3, and Mode B; reuse-before-building appears in both its own section and Mode B's precondition — which is trimmable duplication, matching 'efficient; minor instances that could be trimmed' rather than the every-token-earns-its-place 5 anchor. | 4 / 5 |
Actionability | Commands are copy-paste ready with exact flags verified against the bundle ("python3 {skill_dir}/scripts/bucket_scan.py {root_uri} --output ... --timeout 60"; "datachain bucket status {root_uri}"), alongside a concrete estimation formula ("wall ≈ files × per-row × 1.5 / parallel"), a per-row cost table, and specific decision thresholds ("below ~0.5× → kill it"; "run 3-5 items with .persist() (never .save()), budget 60 s") — fully executable with the common cases covered. | 5 / 5 |
Workflow Clarity | Steps 1–7 are clearly sequenced with explicit validation checkpoints and error-recovery loops throughout: pre-flight access check ("If denied / not found, stop and ask"), timeout fallback ("Handle timeout (exit code 124). Run the hierarchical fallback"), throughput monitoring with kill/revise rules ("at or above ~0.66× the expected rate → carry on; below ~0.5× → kill it"), and an early-exit ("If up_to_date: true... stop") — this batch-operation skill has the feedback loops the 5 anchor requires. | 5 / 5 |
Progressive Disclosure | Good structure: the heavy lifting is properly externalized into 13 bundled scripts and all script references in the body (bucket_scan.py, plan.py, dataset_all.py, render_index.py, cleanup_json.py, bucket_overview.py) resolve to real files; however Step 4 references {skill_dir}/prompts/enrich.md and prompts/enrich_bucket.md, and no prompts/ directory exists in the bundle — real but bounded organization gaps, so 4 rather than the well-signaled-and-complete 5 anchor. | 4 / 5 |
Total | 18 / 20 Passed |