Content
72%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.
The content is highly actionable with copy-paste-ready commands and no concept padding, but it lacks validation checkpoints around its destructive/batch operations and its referenced bundle files do not exist while the bulk command reference is inlined. Adding verification steps and either creating or removing the dangling references would lift the two capped dimensions.
Suggestions
Add explicit validation/confirmation steps before destructive commands — e.g. 'Before `hf repo delete`, run `hf repo list` to confirm the target; deletion is irreversible.'
Create references/commands.md and references/examples.md (or remove the References section) so navigation is not broken, and move the bulk command detail out of SKILL.md into commands.md to reduce duplication with the Quick Reference table.
Add a feedback loop to the Sync Space pattern (verify the upload result / re-list files) since '--delete="*"' is a destructive batch operation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely executable commands with terse inline comments and no concept over-explanation, but the 'Quick Command Reference' table duplicates much of the 'Core Commands' section and 'Common Patterns' re-shows commands already listed — minor instances that could be trimmed (anchor 4, not the fully lean 5). | 4 / 5 |
Actionability | Every section gives fully executable, copy-paste-ready commands with real flags (e.g. 'hf download <repo_id> --local-dir ./models', 'hf upload <repo_id> . . --create-pr') covering auth, download, upload, repo/cache management, jobs, and endpoints across common cases (anchor 5). | 5 / 5 |
Workflow Clarity | Multi-step patterns like Publish (create → upload → tag) and Sync Space are sequenced, but destructive/batch operations ('hf repo delete', 'hf repo-files delete', 'hf cache rm', 'hf endpoints delete', sync with '--delete="*"') carry no validation or confirmation checkpoints, so per the rubric cap workflow_clarity is held at 3. | 3 / 5 |
Progressive Disclosure | Section structure is clear and the References section signals 'references/commands.md' and 'references/examples.md', but those files do not exist (broken references) and a near-complete command reference is inlined in SKILL.md itself — content that the doc says belongs in a separate file is inline (anchor 3). | 3 / 5 |
Total | 15 / 20 Passed |