Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a clear, validated search-write-validate workflow and rich executable examples. Its main weaknesses are duplicated mandatory-instruction sections and inline reference material plus dangling schema file references.
Suggestions
Merge the top "Required Tool Calls" and bottom "MANDATORY" sections into one canonical workflow to remove the repeated flag and retry instructions.
Move the Liquid reference (delimiters, tags, filters, global objects) into a references/ file and link to it, keeping SKILL.md as an overview.
Either add the missing schemas/ files (section.json, theme_block.json, theme_settings.json, translations.json) or remove the dangling references to them.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most content is dense, useful reference (filter/tag/object lists, executable examples) that earns its tokens, but the search-then-validate workflow and the --artifact-id/--revision flag explanations are repeated in both the top "Required Tool Calls" section and the bottom "MANDATORY" sections, which could be consolidated. | 2 / 3 |
Actionability | Guidance is concrete and copy-paste ready: exact commands (scripts/search_docs.mjs, scripts/validate.mjs with full flag sets) and complete executable Liquid examples for form, render, paginate, liquid, image_tag, and a full schema block. | 3 / 3 |
Workflow Clarity | The sequence is explicit and gated — search before writing, validate before returning, and a defined failure loop (read error, search, fix, re-validate, max 3 retries then return best attempt) — with validation as a hard checkpoint before output. | 3 / 3 |
Progressive Disclosure | Sections are well organized and the two script references resolve, but the large Liquid reference (delimiters, tags, filters, global objects) is inline rather than split into a reference file, and four referenced schema paths (schemas/section.json, theme_block.json, theme_settings.json, translations.json) do not exist in the bundle. | 2 / 3 |
Total | 10 / 12 Passed |