Content
61%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 body delivers actionable templates and a reasonable scaffold checklist in a well-structured, self-contained form. It would benefit from tighter deduplication of templates and an explicit numbered workflow with validation checkpoints.
Suggestions
Collapse the frontmatter template and minimal skill template into one canonical template to remove redundancy and tighten conciseness.
Reframe the scaffold bullets as a numbered workflow with explicit validation checkpoints (e.g. verify .env ignored, confirm scripts/ present, dry-run the new skill).
Trim the "Notes from OpenCode docs" section to only non-obvious facts, relying on the existing reference link for basics.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient but includes some redundancy (overlapping frontmatter and minimal-skill templates) and restates basic facts in "Notes from OpenCode docs" that could be trimmed. | 3 / 5 |
Actionability | Provides copy-paste-ready bash ("mkdir -p .opencode/skills/<skill-name>"), concrete scaffold file lists, and full frontmatter/minimal templates, with only minor gaps. | 4 / 5 |
Workflow Clarity | The scaffold is presented as a bulleted sequence with one verify step ("verify .env is not tracked"), but checkpoints are largely implicit and the steps are not a clearly numbered workflow with feedback loops. | 3 / 5 |
Progressive Disclosure | Content is well-organized into clear sections (Trigger phrases, Frontmatter template, Quick Usage, .env, Minimal template, Notes, Reference) with no need for external bundle files; minor organization gaps keep it below 5. | 4 / 5 |
Total | 14 / 20 Passed |