Content
67%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 actionable and well-organized, with concrete commands, explicit scaffold rules, validation checkpoints, and copy-ready templates. Main weaknesses are redundancy between the scaffold checklist and the dedicated .env/template sections, and a workflow whose steps are presented out of order without error-recovery guidance.
Suggestions
Consolidate the .env/.gitignore guidance that currently appears in both the scaffold checklist and the dedicated sections, and merge the two overlapping frontmatter/skill templates into one.
Reorder the body to follow the actual execution sequence (mkdir → scaffold files → write SKILL.md from template → validate), and add a brief "if validation fails, fix and re-check" loop.
Replace bare placeholders in the minimal template ("Action 1", "command here") with a short worked example of a real generated skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean (checklists, commands, templates) but includes avoidable duplication: the .env/.gitignore rules appear both in the scaffold checklist and again in dedicated sections, and two overlapping templates ("Frontmatter template" and "Minimal skill template") repeat each other; awkward phrasing ("This should trigger this scaffold", "skills that are self-buildable") could also be tightened. It is not anchor 4 because several of these redundancies are noticeable, and not anchor 2 because there is no padding explaining concepts Claude already knows. | 3 / 5 |
Actionability | Concrete, executable guidance dominates: the bash command "mkdir -p .opencode/skills/<skill-name>", an explicit minimum-scaffold file list, and copy-ready YAML/markdown templates with specific rules ("create a `.env.example` without credentials", "Always add a `.gitignore`... that ignores `.env`"). It falls short of anchor 5 only because the "Minimal skill template" contains bare placeholders ("command here", "Action 1") and there is no worked example of a finished generated skill. | 4 / 5 |
Workflow Clarity | The sequence is discernible (create folder → add scaffold files → apply scaffold rules → validate description → verify .env not tracked) with real checkpoints ("Quick validation" checklist, "verify `.env` is not tracked"). It is not anchor 5 because there are no error-recovery feedback loops (what to do when validation fails), and the ordering scatters workflow steps between template sections rather than presenting one coherent ordered procedure. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and the ~97-line body is organized into clear, well-labeled sections (scaffold rules, trigger phrases, templates, .env, notes, reference) with a single external link clearly signaled ("Follow the official OpenCode skills docs"). It is below anchor 5 because the content exceeds simple-skill scale with some redundancy and interleaved template sections that could be consolidated, though no references are buried and nothing requires deep navigation. | 4 / 5 |
Total | 15 / 20 Passed |