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, highly actionable MCP skill body: exact tool names, parameters, and error-recovery pitfalls throughout, with well-sequenced workflows and a clear setup validation flow. The main improvements are removing redundant sections (Known Pitfalls duplicates, the filler "When to Use") and splitting the Quick Reference into a separate file to slim the main SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational data — exact tool slugs, parameters, and pitfalls — with zero explanation of concepts Claude already knows. Not 5 because the "Known Pitfalls" section repeats pitfalls already stated in workflow 1, the Quick Reference table re-lists every tool, and the "When to Use" section ("This skill is applicable to execute the workflow or actions described in the overview") is pure filler. | 4 / 5 |
Actionability | Every workflow names exact MCP tool slugs (e.g. `FIGMA_GET_FILE_JSON`), concrete parameters (`ids` as comma-separated string, `simplify: True` for 70%+ size reduction), and actionable error remedies (413 → narrow scope or reduce depth; check `data_preview` if `data` is absent). This is fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | Each workflow has a numbered tool sequence tagged [Prerequisite]/[Required]/[Optional] with a "When to use" clause, and the Setup section includes explicit validation (confirm connection ACTIVE before running). Not 5 because per-workflow validation checkpoints are only implicit via the pitfalls sections rather than explicit steps in the sequences (e.g., verify rendered URLs are non-null before downloading). | 4 / 5 |
Progressive Disclosure | Well-organized single-file skill (no bundle files exist) with clear section headers, consistent per-workflow formatting, and a navigable Quick Reference table. Not 5 because at ~177 lines some content (the full Quick Reference table and detailed pitfalls) could live in a separate reference file, and the redundant "Known Pitfalls" and filler "When to Use" sections add navigation noise. | 4 / 5 |
Total | 17 / 20 Passed |