Content
93%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 an exemplary lean, actionable overview: exact syntax, named APIs, and concrete error-avoidance guidance, with a well-organized one-level-deep reference structure. The only minor gap is that batch/destructive validation feedback loops live in a referenced file rather than inline.
Suggestions
Surface a one-line validation/retry guidance for batch and destructive operations directly in the batch-modify entry so the feedback loop is visible without loading the reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense with operational facts (exact error strings, the precise ToolSearch 'select:' syntax, font-name gotchas) and never pads by explaining what FigJam or MCP is; every token earns its place, matching the 'Lean and efficient; assumes Claude's competence' anchor. | 5 / 5 |
Actionability | Guidance is concrete and copy-paste-ready: the exact ToolSearch query string, named APIs to call and avoid (get_figjam, upload_assets vs figma.createImage), and the canonical load→await→mutute→return text recipe — no pseudocode, fully executable. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit checkpoints and recovery guidance (get IDs upfront via get_figjam, re-call get_figjam rather than re-running inspection scripts if an ID is missing), but the batch/destructive operations defer their validation feedback loops to the referenced batch-modify file rather than stating them inline, leaving a minor validation gap. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a concise overview that points to 12 one-level-deep reference files, each with a clear one-line annotation under a well-signaled '## Reference Docs' section, and every referenced path resolves to an existing file in ./references/, matching 'Clear overview with well-signaled one-level-deep references; easy navigation'. | 5 / 5 |
Total | 19 / 20 Passed |