CtrlK
BlogDocsLog inGet started
Tessl Logo

novu-trigger-notification

Trigger Novu notification workflows to send messages across email, SMS, push, chat, and in-app channels. Supports single triggers, bulk triggers, broadcast to all subscribers, topic-based targeting, and cancellation. Use when sending transactional notifications, alerts, or any event-driven messages.

68

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

76%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.

A lean, highly actionable reference with executable TypeScript for every trigger variant and a genuinely useful pitfalls section. The main weakness is the absence of validation/feedback-loop steps for its batch operations (triggerBulk, triggerBroadcast), which caps workflow clarity at 3; progressive disclosure is good but references are not contextually signposted.

Suggestions

Add validation guidance for batch and broadcast operations: show how to inspect the returned result for errors (e.g., checking `result.data` for accepted/errored events) and confirm payload size before broadcast, since bulk (100-event) and environment-wide broadcast triggers currently have no verification or feedback loop.

Signal references at point of use: link the relevant reference file inline in each section (e.g., '## Bulk Trigger ... see [bulk-trigger-examples.md]') instead of only listing all five in a trailing References section, making navigation to deeper material immediate.

Trim the opening line that duplicates the frontmatter description and consolidate the inline-subscriber-creation and transaction-id variants under Single Trigger with a brief note each, tightening the body without losing any Novu-specific detail.

DimensionReasoningScore

Conciseness

The body is efficient — every section conveys Novu-specific API knowledge Claude cannot infer ("Bulk trigger limit is 100 events", "workflowId is the identifier, not the display name") with no padding about what notifications are. Minor trimming is possible: the opening line "Send notifications by triggering Novu workflows. Supports single, bulk, broadcast, and topic-based delivery" restates the frontmatter description, and the Single Trigger variants could be slightly consolidated — so it fits the level-4 anchor (efficient, minor over-explanation) rather than the lean level-5 anchor.

4 / 5

Actionability

All examples are fully executable copy-paste-ready TypeScript covering the common cases — SDK instantiation ("const novu = new Novu({ secretKey: process.env.NOVU_SECRET_KEY })"), single/bulk/broadcast/topic triggers, and cancellation — plus a parameter table with required/optional flags and concrete override syntax. This matches the level-5 anchor: specific examples cover the common cases with no gaps.

5 / 5

Workflow Clarity

Each operation is presented as an unambiguous, clearly organized procedure, but the skill includes batch and environment-wide operations ("Send up to 100 events in a single request" via triggerBulk, and triggerBroadcast "to all subscribers") with no validation or verification steps — no error handling of the returned result, no payload sanity check before broadcast, no retry guidance. Per the judging guideline capping workflow clarity at 3 for batch/destructive operations without validation, this cannot exceed 3 even though the per-operation structure is clean.

3 / 5

Progressive Disclosure

SKILL.md is a well-organized overview whose detail is appropriately split into five real one-level-deep reference files (installation.md, single/bulk/topic-trigger-examples.md, best-practices.md), verified to exist with no nested-chaining problem. It falls short of the level-5 anchor only because the references are listed in a trailing References section rather than signaled at the point of use (e.g., the Bulk Trigger section does not inline-link to bulk-trigger-examples.md), which is exactly the 'references mostly clear; minor organization gaps' of level 4.

4 / 5

Total

16

/

20

Passed

Description

92%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, third-person, concrete description that names all capability variants and pairs them with an explicit 'Use when...' clause. Trigger-term coverage is good though a few natural user phrasings (e.g., 'notify users') are absent, keeping trigger term quality at 4.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — "Trigger Novu notification workflows to send messages across email, SMS, push, chat, and in-app channels. Supports single triggers, bulk triggers, broadcast to all subscribers, topic-based targeting, and cancellation" — comprehensively covering the skill's capabilities with no generic filler. It goes beyond the level-4 anchor ("several specific actions; minor gaps") because every operation variant in the body (single, bulk, broadcast, topic, cancel) is named.

5 / 5

Completeness

It clearly answers both questions: the "what" is concrete ("Trigger Novu notification workflows... single triggers, bulk triggers, broadcast... topic-based targeting, and cancellation") and the "when" is explicit with concrete trigger phrases ("Use when sending transactional notifications, alerts, or any event-driven messages"). This matches the level-5 good_overall_example structure exactly; not level 4 because the 'when' clause is already explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

Good keyword coverage including natural phrases users would say: "send messages across email, SMS, push, chat, and in-app channels", "transactional notifications", "alerts", "event-driven messages". It falls short of the level-5 anchor's comprehensive synonym coverage (e.g., missing variations like "notify users", "send an email/SMS to subscribers") but is noticeably above the midpoint — users asking to "send a notification" or "send an alert" would hit this description.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — Novu-branded notification orchestration with distinct triggers (workflow triggering, broadcast, topic-based targeting) — so risk of firing for an unrelated skill is minimal. Not level 4: even against closely related skills (e.g., a raw SendGrid/email skill), the Novu-specific vocabulary and trigger semantics keep it clearly distinguishable.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
novuhq/novu
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.