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 skill body: dense, executable, and well-structured, with validation baked in through dedicated test and verify steps plus a pre-flight checklist. The sole realistic improvement is removing the duplicated types.py pointers in Step 2 to reach full token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and code-first, assumes competence (never explains dataclasses, protocols, or registries), and conveys repo-specific knowledge via compact tables. It falls short of anchor 5 only on minor trims: Step 2 points to src/sentry/notifications/platform/types.py twice with near-duplicate sentences ("> For examples, load..." and "All NotificationCategory options are defined in..."). | 4 / 5 |
Actionability | Every step ships copy-paste-ready code: the dataclass, template registration via @template_registry.register, the sending pattern with rollout guard, the get_renderer override, and three complete test classes, plus a runnable pytest command. All file paths are concrete, matching the anchor-5 'fully executable; copy-paste ready' example. | 5 / 5 |
Workflow Clarity | Step 1's routing table dispatches to the right operation, steps are explicitly sequenced with a directive to continue to Test and Verify, and Step 9 is a pre-flight checklist with a specific test command. Validation is reinforced by a named guardrail test (test_example_links_are_classified), satisfying the anchor-5 'explicit validation steps; checklists' description. | 5 / 5 |
Progressive Disclosure | SKILL.md stays an overview and offloads depth to four clearly signaled blockquote pointers (references/data-and-templates.md, targets-and-sending.md, custom-renderers.md, provider-template.md), all of which exist in the bundle. References are exactly one level deep with no nested indirection, matching the anchor-5 'clear overview with well-signaled one-level-deep references'. | 5 / 5 |
Total | 19 / 20 Passed |