CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

notification-platform

Guide for adding notifications, custom renderers, or new providers to Sentry's NotificationPlatform. Use when asked to "add notification", "new notification", "notification platform", "send notification", "notification template", "notification renderer", "notification provider", "NotificationPlatform", "notify user", "send email notification", "send slack notification".

80

0.96x
Quality

93%

Does it follow best practices?

Impact

92%

0.96x

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it names the platform and its three extension points, uses third-person voice, and provides an explicit, richly populated 'Use when asked to' trigger list. The only weaknesses are high-level action naming and a few trigger phrases generic enough to overlap with unrelated notification work.

DimensionReasoningScore

Specificity

Lists three concrete, distinct actions ("adding notifications, custom renderers, or new providers") scoped to Sentry's NotificationPlatform, matching the 'several specific actions; minor gaps' anchor. It stays below anchor 5 because the actions are named at a high level without finer-grained capabilities (e.g., defining data/templates, rollout registration, testing), and above anchor 3 because more than 1-2 actions are explicitly covered.

4 / 5

Completeness

Explicitly answers both: what it does ("Guide for adding notifications, custom renderers, or new providers to Sentry's NotificationPlatform") and when to use it ("Use when asked to..." followed by concrete trigger phrases). This mirrors the anchor-5 example structure exactly, and the 'when' clause is present so it cannot be a 3 or below.

5 / 5

Trigger Term Quality

Eleven quoted natural phrases a user would actually say, including synonyms and provider-specific variants ("add notification", "send notification", "send email notification", "send slack notification", "NotificationPlatform"). Comprehensive natural-term coverage matches the top anchor; no common variation of the request is obviously missing.

5 / 5

Distinctiveness Conflict Risk

The scope is clearly niched to Sentry's NotificationPlatform with distinctive triggers ("NotificationPlatform", "notification renderer"), but generic phrases like "notify user" and "send notification" carry minor overlap risk with other notification-related work in the same codebase. This fits 'mostly distinct; minor overlap risk' rather than anchor 5's 'minimal conflict risk'.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

getsentry/sentry

Path

.agents/skills/notification-platform/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.