Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, highly actionable skill with a clear multi-step workflow and strong validation checkpoints. Its main weakness is verbosity — it re-explains concepts delegated to the `cds-code` skill and includes detailed inline content that could be split into supporting files. The workflow sequencing and error handling are excellent, making this a reliable guide for the Figma-to-CDS translation process.
Suggestions
Extract the 'Props before style' section and the 'Translating fallback HTML and Tailwind classes' section into a separate reference file (e.g., TRANSLATION_GUIDE.md) to reduce the main skill's token footprint.
Trim the 'When to use' and 'Prerequisites' sections — Claude can infer most of these conditions from context, and the negative cases ('Do not use when...') add tokens without much value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is well-structured but verbose in several areas. It explains concepts Claude would understand (e.g., what a Figma URL looks like, what Code Connect is), includes lengthy tables and checklists that could be tightened, and repeats guidance already delegated to the `cds-code` skill (e.g., 'Props before style' section rehashes rules it says are in the other skill). The 'When to use' and 'Prerequisites' sections are reasonable but could be leaner. | 2 / 3 |
Actionability | The skill provides concrete, executable MCP tool calls (e.g., `get_design_context(fileKey=..., nodeId=...)`, `get_screenshot(...)`), specific URL parsing examples with before/after values, a clear confidence hierarchy table for translating Figma output, and detailed translation examples (e.g., `flex-row` → `HStack`). The guidance is specific enough to be directly followed. | 3 / 3 |
Workflow Clarity | The 8-step workflow is clearly sequenced with explicit ordering ('Follow these steps in order. Do not skip steps.'). It includes validation checkpoints (Step 7 visual comparison loop, Step 8 validation checklist), error recovery paths (truncated responses, missing MCP servers, fallback HTML), and a corrective feedback loop (implement → compare → correct → re-check). The validation checklist in Step 8 is thorough. | 3 / 3 |
Progressive Disclosure | The skill appropriately delegates CDS coding standards to the `cds-code` skill with clear references, but the SKILL.md itself is monolithic at ~250+ lines with no bundle files to offload detailed content. The 'Props before style' section and translation examples could be in a separate reference file. The common issues section is inline when it could be a separate troubleshooting doc. However, the cross-references to `cds-code` are well-signaled. | 2 / 3 |
Total | 10 / 12 Passed |