novu-manage-subscribers

Create, update, search, and delete subscribers in Novu. Manage topics for group-based notification targeting. Set subscriber credentials for push and chat channels. Use when managing notification recipients, creating subscriber records, organizing subscribers into topics, or configuring channel-specific credentials.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

87%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A concise, highly actionable API skill body with clean progressive disclosure via real reference files. Its one weakness is workflow clarity: batch and destructive operations ship without validation checkpoints or error-recovery guidance.

Suggestions

Add validation/verification steps for risky operations: after createBulk, check the response for per-subscriber success and retry failures; before delete, note it is irreversible and that existing notifications persist (already a pitfall) so the caller can confirm.

For createBulk specifically, document how to handle partial failures across the 500-subscriber batch rather than presenting it as a fire-and-forget call.

Fix the typo "subsriberId-1" in the FCM credentials example so the copy-paste-ready code is accurate.

Dimension	Reasoning	Score
Conciseness	The body is lean and code-first — each operation is a tight code block with only Novu-specific notes; it does not explain concepts Claude already knows, and the Common Pitfalls add genuinely non-obvious per-environment/autocreate behavior. Not the level below because there is no unnecessary explanation or padding to tighten.	3 / 3
Actionability	Every operation (create, retrieve, search, patch, delete, createBulk, topics CRUD, FCM/APNS credentials) ships as concrete, copy-paste-ready TypeScript with realistic values, matching the fully-executable anchor. A minor typo ("subsriberId-1" in the FCM example) does not undermine the executability of the guidance.	3 / 3
Workflow Clarity	Individual operations are unambiguous, but the batch operation (createBulk, 500 subscribers) and destructive operations (delete) lack any validation checkpoints or feedback loops, which the rubric's scoring notes explicitly cap at 2. It is not a 3 because there are no verify-after-write or error-recovery steps for these risky operations.	2 / 3
Progressive Disclosure	The body is a clear overview with a well-signaled one-level-deep References section pointing to three real, existing files (subscriber-crud-examples.md, topics-examples.md, credentials-examples.md), giving easy navigation without nested references.	3 / 3
	Total	11 / 12 Passed

Description

100%

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, well-constructed description: concrete capabilities, explicit trigger guidance, and a clear Novu-specific niche with low conflict risk. It earns top marks across all dimensions.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "Create, update, search, and delete subscribers", "Manage topics for group-based notification targeting", "Set subscriber credentials for push and chat channels" — matching the anchor for comprehensive, specific actions rather than the partial-coverage level below.	3 / 3
Completeness	It explicitly answers both what (CRUD + topics + credentials) and when via an explicit "Use when…" trigger clause, which the rubric requires for the top completeness anchor.	3 / 3
Trigger Term Quality	The "Use when managing notification recipients, creating subscriber records, organizing subscribers into topics, or configuring channel-specific credentials" clause supplies natural, user-sayable terms (subscribers, topics, notification recipients, credentials) with good coverage, not just narrow jargon.	3 / 3
Distinctiveness Conflict Risk	The Novu subscriber/topic management niche with its own distinct triggers is unlikely to fire for unrelated skills, fitting the clear-niche anchor.	3 / 3
	Total	12 / 12 Passed

Validation

87%

Warnings & errors only

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

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
relative_links	Relative link issues: 1 suspicious	Warning

	Total	14 / 16 Passed

Repository: novuhq/novu
Path: docs/.mintlify/skills/manage-subscribers/SKILL.md
Commit: d921755

Reviewed: about 14 hours ago

Table of Contents

Discovery Implementation Validation

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.