Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced skill body with excellent progressive disclosure and validation checkpoints. Its main weakness is conciseness: large portions of the visual-conventions block duplicate constants already in the foundation reference files it cites as source-of-truth.
Suggestions
Replace the inlined color, typography, section-property, and vertical-spacing tables in the 'Visual UI conventions' block with a brief pointer to foundation/palette.md and foundation/layout.md, keeping only the few rules (e.g. ARCH_PALE-not-FigJam-SECTION, section.name = '') that need in-context emphasis.
Consolidate the repeated wrapper/alignment/64px-gap rules — currently restated in 'Outer wrapper + column alignment', 'Vertical spacing', the code blocks, and the operational rules — into one authoritative section.
The 'What NOT to use' table overlaps heavily with the inline tables above it; fold the essential pitfalls into the operational rules and remove the rest to cut redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body duplicates content that lives in the referenced source-of-truth files (the full color, typography, section-property, and vertical-spacing tables restate foundation/palette.md and foundation/layout.md) and restates wrapper/spacing rules across several sections, so it could be tightened despite holding genuinely novel FigJam domain knowledge. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready JS (outer-wrapper creation, re-stack pass, first-run probe, connector delete-and-recreate) plus exact constants and tool calls, matching the top anchor. | 3 / 3 |
Workflow Clarity | A clearly sequenced 9-step workflow with a consistent Inputs/Ask/Tools/Do/Checkpoint template, explicit screenshot + AskUserQuestion validation checkpoints on every Write step, self-checks on Research steps, and stated failure handling for diagrams. | 3 / 3 |
Progressive Disclosure | SKILL.md is a clear overview with well-signaled one-level-deep references (4 foundation files, section-catalog, 9 block files), all verified to exist and each annotated with when to load — easy navigation with no deep nesting. | 3 / 3 |
Total | 11 / 12 Passed |