Agent skill

Novu Design Workflow

by novuhq in novuhq/novu

Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state.

Custom licenceAuto-check passedBackend & APIs

Install Novu Design Workflow

skills CLI
$ npx skills add novuhq/novu --skill novu-design-workflow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install novuhq/novu novu-design-workflow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/novuhq/novu.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/.mintlify/skills/design-workflow .claude/skills/novu-design-workflow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
novu-design-workflow
GitHub stars
40k
Token cost
~2.6k tokens
SKILL.md length
978 words
Files
6 (incl. references)
Skills in repo
28
Repo updated
First seen
Licence
Custom licence

At a glance

Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state.

  • Works in 8 steps: Don't set severity by default — leave it… → critical: true is not the same as… → Don't add fallbacks when the user named… → …
  • Planning a new workflow
  • SKILL.md covers When to use this skill, Severity & Critical, Channel Selection and Digest Defaults, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Novu Design Workflow is an agent skill from novuhq/novu. Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state. Applies to BOTH dashboard-authored and code-first (@novu/framework) workflows. Use when planning a new workflow, deciding which channels to include, picking severity, configuring digest behavior, or matching a use case (order confirmation, payment failed, account suspended, comment, trial expiring, password reset, webhook fan-out…

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `references/channel-selection.md`, `references/digest-defaults.md` and `references/severity-and-critical.md`).

It sits in Backend & APIs, covering Webhooks. The repository describes itself as: The open-source communication infrastructure for agents and products.

When your agent uses it

  • Planning a new workflow
  • Deciding which channels to include
  • Picking severity
  • Configuring digest behavior

Example prompts

  • “/novu-design-workflow”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Don't set severity by default — leave it unset unless you actually need visual prioritization.
  2. critical: true is not the same as readOnly: true — readOnly only hides the workflow from the Preferences UI; critical bypasses preferences…
  3. Don't add fallbacks when the user named the channels — explicit channel requests are exact.
  4. Cap the channel count at 3 when the user didn't specify channels. More channels = more annoyance, not more reach.
  5. Don't combine digest with critical: true — critical workflows must deliver immediately. The digest step is auto-skipped.
  6. Digest key matters for conversational flows — without +threadId, a comment on Post A and a comment on Post B end up in the same digest.
  7. Push only when offline — sending push to an online user duplicates the In-App alert.
  8. HTTP step needs responseBodySchema — without it, downstream steps can't read response properties via {{ steps.. }}.

What it can do on your machine

Read from SKILL.md and the folder at commit c4d3eda. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • jsonlogic.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Novu Design Workflow loads about 2.6k tokens when it runs, and up to ~9.8k if it reads all its reference files. Until then it costs about 141 tokens; SKILL.md has 978 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~141
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~9.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 978 words (~2,640 tokens).

“Design rules for any Novu workflow — independent of whether you author it in the Dashboard (no-code) or in code with @novu/framework. The decisions here (channels, severity, critical, digest, conditions) are the same on both surfaces; only the syntax differs.”

— opening of SKILL.md by novuhq, Custom licence
name
novu-design-workflow

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files (references) in docs/.mintlify/skills/design-workflow of novuhq/novu.

  • SKILL.md
  • references/channel-selection.md
  • references/digest-defaults.md
  • references/severity-and-critical.md
  • references/step-conditions.md
  • references/workflow-templates.md

Open the folder on GitHubat commit c4d3eda

Compare with similar skills

Novu Design Workflow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Novu Design Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novu Design Workflow this skillnovuhq/novu40k—~2.6kAutomated safety check: PassCustom licence
Golivemikehasa/golive-skill1.3k—~13kAutomated safety check: NotesMIT
Stripe Appsfossasia/eventyay1.7k1 repos~3.6kAutomated safety check: PassApache-2.0
Dingtalk Messageagentscope-ai/ReMe3.6k—~1.6kAutomated safety check: PassApache-2.0
PR Review Provideryansongda/pay5.4k—~2.4kAutomated safety check: PassMIT
Stripe Best Practiceskanchengw/cnllm1732 repos~925Automated safety check: PassApache-2.0

Similar skills

  • Golive

    mikehasa/golive-skill

    Take an agent-written app from repo to live production on the user's OWN accounts, with providers they choose (hosting, database, auth, payments, email, domain/DNS).

    1.3k GitHub stars~13k tokensUpdated 7 days ago
    Backend & APIsAuto-check: notes
  • Stripe Apps

    fossasia/eventyay

    A skill your agent uses when building, modifying, or reviewing a Stripe App — or when the user describes something that implies one (e.g.

    1.7k GitHub starsUsed in 1 repo~3.6k tokens
    Backend & APIsAuto-check passed
  • Dingtalk Message

    agentscope-ai/ReMe

    钉钉消息发送技能。支持企业内部机器人(批量单聊/群聊)和 Webhook 自定义机器人两种接入方式,支持多机器人管理,支持文本、Markdown、链接、ActionCard、FeedCard等多种消息类型。

    3.6k GitHub stars~1.6k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • PR Review Provider

    yansongda/pay

    A skill your agent uses when reviewing PRs that add or modify a payment Provider in yansongda/pay - covers plugin pipeline, multi-tenant safety, signature verification, docs, and naming conventions.

    5.4k GitHub stars~2.4k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Stripe Best Practices

    kanchengw/cnllm

    Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial…

    173 GitHub starsUsed in 2 repos~925 tokens
    Backend & APIsAuto-check passed
  • Email Best Practices

    viclafouch/meme-studio

    A skill your agent uses when building email features, emails going to spam, high bounce rates, setting up SPF/DKIM/DMARC authentication, implementing email capture, ensuring compliance (CAN-SPAM…

    110 GitHub starsUsed in 7 repos~787 tokens
    Backend & APIsAuto-check passed

More from novuhq/novu

All 28 skills in this repo
  • Ink Tui Wizard

    novuhq/novu

    Build terminal user interfaces (TUIs) using Ink (React for CLIs) and @inkjs/ui with a reactive, session-driven wizard pattern.

    40k GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Integrate Novu's in-app notification inbox into web applications.

    40k GitHub stars~5.2k tokensUpdated yesterday
    Auto-check passed
  • Configure notification preferences in Novu at the workflow and subscriber level.

    40k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Create, update, search, and delete subscribers in Novu. An agent skill from novuhq/novu.

    40k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Trigger Novu notification workflows to send messages across email, SMS, push, chat, and in-app channels.

    40k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Testerarmy CLI

    novuhq/novu

    Use TesterArmy CLI to create, organize, and run dashboard-managed QA tests.

    40k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Novu Design Workflow

What does Novu Design Workflow do?

Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state. Novu Design Workflow is an agent skill from novuhq/novu. Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state.

When should I use Novu Design Workflow?

Novu Design Workflow fits situations like: planning a new workflow; deciding which channels to include; picking severity; configuring digest behavior.

How do I install Novu Design Workflow in Claude Code?

Run `npx skills add novuhq/novu --skill novu-design-workflow -a claude-code`. Or copy the skill folder (docs/.mintlify/skills/design-workflow in novuhq/novu) into .claude/skills/novu-design-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Novu Design Workflow in Codex?

Run `npx skills add novuhq/novu --skill novu-design-workflow -a codex`. Or copy the skill folder (docs/.mintlify/skills/design-workflow in novuhq/novu) into .agents/skills/novu-design-workflow in your project. Codex loads it when a task matches its description.

Can I use Novu Design Workflow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add novuhq/novu --skill novu-design-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/novu-design-workflow, .gemini/skills/novu-design-workflow, .github/skills/novu-design-workflow and .opencode/skills/novu-design-workflow in your project.

What does Novu Design Workflow need to run?

SKILL.md names no scripts, command-line tools or credentials: Novu Design Workflow is instructions for the agent only.

Does Novu Design Workflow access the network?

SKILL.md names 1 domain. As links in the text: jsonlogic.com. This is read from the text; nothing was executed.

Is Novu Design Workflow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Novu Design Workflow use?

Novu Design Workflow has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Novu Design Workflow use?

About 2.6k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.1k tokens, read only when the agent opens those files.

What are the alternatives to Novu Design Workflow?

Skills that share tags, products or a category with Novu Design Workflow: Golive (mikehasa/golive-skill, 1.3k stars), Stripe Apps (fossasia/eventyay, 1.7k stars), Dingtalk Message (agentscope-ai/ReMe, 3.6k stars) and PR Review Provider (yansongda/pay, 5.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Novu Design Workflow?

novuhq (a GitHub organization) maintains it in novuhq/novu, which has 40,132 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 10, 2026.

Source: novuhq/novu on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.