Content
82%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.
A strong, dense API reference with executable code, explicit API-vs-API decision guidance, and concrete limits. The only real weaknesses are a dated, off-topic Observability digression and a monolithic structure where secondary Next.js/CLI/CDN material could move to reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every section delivers product-specific facts Claude cannot know (limits table, 300ms tag propagation, tag rules, ISR isolation), with code kept tight. The Observability section digresses into dated CDN-dashboard changelog detail ('March 5, 2026', 'project-level routing') unrelated to the Runtime Cache, which is exactly the kind of trimmable, time-sensitive content that keeps this below anchor 5. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready TypeScript and CLI commands covering the common cases: cache-aside fetch handler, tag expiration from a Server Action, CLI purge/invalidate/dangerously-delete with flags, plus a limits table and a deprecated-API warning. This matches the anchor for complete, executable guidance covering common cases. | 5 / 5 |
Workflow Clarity | As an API-reference skill it has no stepwise workflow, but decision guidance is explicit: the 'Important distinction' callouts (cache.expireTag vs invalidateByTag), the Runtime Cache vs ISR isolation rules, and When to Use / When NOT to Use sections act as clear checkpoints, and the destructive command carries a stampede-risk warning. It falls short of anchor 5 only because there is no validation step after invalidation (e.g. verifying a tag expired). | 4 / 5 |
Progressive Disclosure | A single-file skill with clear section headers, easy navigation, and an external-links References section; no bundle files exist to reference. It stays at anchor 4 rather than 5 because ~90 lines of secondary material (Next.js Integration, CLI Commands, CDN Cache Tags) is inlined in SKILL.md instead of being split into one-level-deep reference files. | 4 / 5 |
Total | 17 / 20 Passed |