Content
86%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 lean, high-signal framework cheat-sheet: dense gotchas, exact file paths, commands and a concrete loader example, with a sequenced collection workflow ending in a build validation step. The only gaps are the absence of a complete copy-paste code block for collection definition and an explicit fix-and-retry loop after the build check.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is a dense gotcha or instruction ("Astro v5+ defines collections in `src/content.config.ts` (not `src/content/config.ts`)", the client:* ladder with one-word cost labels), assuming Claude's competence and adding only framework-specific knowledge — matching anchor 5. Version references state current truth with the old pattern negated inline rather than using date-conditional guidance, so the time-sensitivity penalty does not apply. | 5 / 5 |
Actionability | Concrete guidance throughout — file paths (`src/pages/api/*.ts`, `astro.config.mjs`), a runnable command (`astro add react tailwind mdx sitemap`), and a near-complete `glob({ pattern: '**/*.{md,mdx}', base: './src/content/blog' })` loader example — matching anchor 4. Not 5 because there is no complete copy-paste code block for defining a collection or calling `getCollection`; not 3 because the guidance is executable and specific, not pseudocode. | 4 / 5 |
Workflow Clarity | "Add a collection" is a clear 4-step sequence with an explicit validation checkpoint ("The build must exit zero"), matching anchor 4. Not 5 because no fix-and-retry feedback loop is described; not 3 because the sequence is present with a checkpoint, and the destructive/batch cap does not apply to this non-destructive workflow. | 4 / 5 |
Progressive Disclosure | The body is under 50 lines, organized into clear sections (Gotchas, Layout, Add a collection, integrations), and no bundle files exist or are needed at this size — matching the rubric's simple-skill exception where well-organized sections alone score 5. Content is appropriately inlined rather than split into reference files. | 5 / 5 |
Total | 18 / 20 Passed |