Content
81%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 is a strong, actionable workflow with excellent validation structure and concrete tool/command guidance. Its main gaps are minor verbosity and the absence of a complete worked code example or split-out reference files.
Suggestions
Remove the duplicated 'Do not start the dev server or take screenshots until Phase 1 is clean' line (it appears in both the Phase 1 intro and step 5) to tighten conciseness.
Add one complete, copy-pasteable CDS component example (e.g. a VStack with gap/paddingX derived from a fallback snippet) to lift actionability from mostly-executable to fully copy-paste ready.
Consider moving the 'Common Issues and Solutions' section and the confidence matrix into a reference file under references/ to improve progressive disclosure now that the skill exceeds 50 lines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~260-line body is mostly earned operational guidance (Figma MCP handling, validation) rather than explanation of basic concepts, with only minor trim opportunities such as the repeated 'do not start the dev server until Phase 1 is clean' line; not lean enough for 5 but clearly above the 3 midpoint. | 4 / 5 |
Actionability | Provides concrete tool calls with parameters (get_design_context, get_metadata(fileKey=..., nodeId=...), get_screenshot), real validation commands (yarn typecheck, tsc -p tsconfig.app.json --noEmit), and a translation table (flex-row -> HStack, font-size/weight -> font="caption"); lacks a complete copy-paste component example, so it stops short of 5. | 4 / 5 |
Workflow Clarity | A six-step ordered workflow with explicit validation checkpoints (Phase 1 code-quality gate, Phase 2 visual parity), feedback loops ('Fix ALL errors before proceeding', corrective implement-compare-correct-recheck loop), and a final checklist, matching the 5 anchor. | 5 / 5 |
Progressive Disclosure | No bundle files exist, but the body is well-sectioned (When to use, Prerequisites, Required Workflow, Common Issues, Communication Style) and defers detail to the cds-code/cds-docs skills; some inline material (Common Issues, the confidence matrix) could be split out, so it sits at 4 rather than 5. | 4 / 5 |
Total | 17 / 20 Passed |