Content
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured and appropriately lean for a simple catalogue entry, with clean progressive disclosure and a single external reference. Its weaknesses are redundant content that duplicates the frontmatter and a vague install step that leaves the core action under-specified.
Suggestions
Replace the verbatim 'What it does' repeat and the 'Source' section (which duplicates frontmatter) with content that adds new information, or remove them to tighten the body.
Make the install step concrete: give the actual commands or paths for copying the upstream bundle into the agent's skills directory instead of describing it abstractly.
Clarify the workflow by numbering the steps (inspect README -> install bundle -> invoke by name/trigger) so the sequence and its checkpoints are explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and mostly lean, but 'What it does' repeats the frontmatter description verbatim and the 'Source' section restates upstream/category already in the frontmatter, so it could be tightened — matching 'mostly efficient but includes some unnecessary explanation'. | 2 / 3 |
Actionability | It offers one concrete command ('open https://github.com/figma/skills') but the core instruction to 'install the upstream bundle into your active agent's skills directory' lacks concrete commands or paths, fitting 'some concrete guidance but incomplete; missing key details'. | 2 / 3 |
Workflow Clarity | A sequence is present (advertise in Open Design, inspect upstream README, install bundle, invoke by name/trigger), but the install step is vague and checkpoints are only implicit, matching 'steps listed but validation gaps; sequence present but checkpoints missing or implicit'. | 2 / 3 |
Progressive Disclosure | The body is under 50 lines with well-organized sections and no local bundle files to navigate, and it appropriately points to a single external upstream URL rather than nesting local references, matching the 'well-organized sections' allowance for simple skills. | 3 / 3 |
Total | 9 / 12 Passed |