Content
92%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.
An exemplary instruction-only skill body: lean, sequenced, with explicit validation checkpoints, feedback loops, security handling for the signing secret, and precise acceptance criteria ('A real completed bot answer is the acceptance check'). The only minor gap is a few underspecified verification steps such as where to check setup metrics.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense; every sentence carries operational content (exact scopes, event subscriptions, URL patterns, security rules, acceptance criteria). No explanation of concepts Claude already knows and no padding — e.g., 'Never replace the entire manifest with only the generated fragment' earns its place. | 5 / 5 |
Actionability | Highly concrete guidance: exact required bot scopes and events, generated URL patterns ('/v1/integrations/slack/<connectionId>/', '/v1/integrations/slack/oauth/callback'), field locations ('Basic Information' to the connector's 'signing-secret field'), the ten-minute authorization window, and the /openwork command. Held below 5 by minor gaps: 'check setup metrics' and 'Send a short DM test' do not specify where or how exactly; manifest 'merge' is described but not operationalized. | 4 / 5 |
Workflow Clarity | Clear four-phase sequence (Establish the target → Configure the existing app → Link the invoking member → Verify and report) with explicit validation checkpoints ('Fix validation errors before saving', 'Verify the Events URL challenge and save its Verified state') and an explicit feedback loop ('If a step fails, inspect its concrete error, make a targeted correction, and retry; stop repeating an unchanged failing installation'). Risky manifest operations are guarded by a before/after comparison requirement, so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | Under 50 lines with no bundle files, organized into clear sections, and the two external guide links are clearly signaled at the top and only one level deep. Content is appropriately self-contained; nothing that belongs in a separate file is inlined. | 5 / 5 |
Total | 19 / 20 Passed |