Content
87%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A strong, action-oriented reference skill: concrete executable code throughout and Satori-specific gotchas that add genuine value. The main gap is the absence of an explicit end-to-end workflow with validation checkpoints, leaving workflow_clarity at 2.
Suggestions
Add a short ordered workflow (install @vercel/og → set runtime='edge' → load a bundled font → render with ImageResponse → verify the response Content-Type is image/png) with an explicit validation step so workflow_clarity can reach 3.
Trim or fold the Key Patterns section into the relevant sections to remove the slight redundancy with the worked examples above it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean, code-heavy content where every section earns its place; the CSS Support/Limitations list and font-loading notes are Satori-specific quirks Claude would not already know. The only mild redundancy is the Key Patterns recap, not enough to drop it below the top anchor. | 3 / 3 |
Actionability | Multiple complete, copy-paste-ready examples — full route handlers, standalone satori() calls, edge-runtime font fetching, and dynamic URL-param rendering — all executable as written. | 3 / 3 |
Workflow Clarity | The skill is organized as parallel recipes rather than an explicit sequenced workflow with validation checkpoints; each recipe is clear, but there is no validate-then-proceed loop or ordering guidance for the cross-cutting concerns. | 2 / 3 |
Progressive Disclosure | Self-contained skill with no bundle files (references/scripts/assets absent) and well-organized labeled sections (Installation, App Router, Convention-Based, Standalone, Fonts, Images); the only external links are official docs, so navigation is trivial. | 3 / 3 |
Total | 11 / 12 Passed |