Agent skill

Novu Framework Integration

by novuhq in novuhq/novu

Build code-first notification workflows with @novu/framework.

Custom licenceAuto-check passedDevOps & Cloud

Install Novu Framework Integration

skills CLI
$ npx skills add novuhq/novu --skill novu-framework-integration -a claude-code

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

GitHub CLI
$ gh skill install novuhq/novu novu-framework-integration --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/framework-integration .claude/skills/novu-framework-integration && 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-framework-integration
GitHub stars
40k
Token cost
~7.2k tokens
SKILL.md length
1,921 words
Files
10 (incl. references)
Skills in repo
28
Repo updated
First seen
Licence
Custom licence

At a glance

Build code-first notification workflows with @novu/framework.

  • Works in 5 steps: Bootstrap a project → Or add to an existing app → Define a workflow → …
  • Defining workflows in TypeScript (Zod / JSON Schema / Class Validator)
  • SKILL.md covers When to Use the Framework, How It Works, Quick Start and Workflow Anatomy, plus 5 more sections
  • Calls npx and npm; reaches api.novu.co and eu.dashboard.novu.co; needs NOVU_SECRET_KEY

What it does

Novu Framework Integration is an agent skill from novuhq/novu. Build code-first notification workflows with @novu/framework. Use when defining workflows in TypeScript (Zod / JSON Schema / Class Validator), composing channel steps (email, SMS, push, chat, in-app) with action steps (delay, digest, custom), exposing Step Controls for non-technical teammates, rendering React/Vue/Svelte Email templates, hosting the Bridge Endpoint inside Next.js, Express, NestJS, Remix, Nuxt, SvelteKit, H3, or AWS Lambda, syncing to Novu Cloud via CLI / GitHub Actions, securing production with…

Its SKILL.md is about 7.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files (for example `references/bridge-endpoint.md`, `references/deployment.md` and `references/email-templates.md`).

It sits in DevOps & Cloud, covering Forms and validation, Transactional email and Translation. It works with React, Svelte, Vue.js and AWS Lambda. The repository describes itself as: The open-source communication infrastructure for agents and products.

When your agent uses it

  • Defining workflows in TypeScript (Zod / JSON Schema / Class Validator)
  • Composing channel steps (email
  • In-app) with action steps (delay
  • Exposing Step Controls for non-technical teammates

Example prompts

  • “/novu-framework-integration”

Requirements

  • Node.js
  • A credential in NOVU_SECRET_KEY
  • A credential in YOUR_NOVU_SECRET_KEY

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Bootstrap a project
  2. Or add to an existing app
  3. Define a workflow
  4. Mount the Bridge Endpoint
  5. Run the Local Studio

What it can do on your machine

Read from SKILL.md and the folder at commit 8a05b88. 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

    Shell commands in SKILL.md call:

    • npx
    • npm

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.novu.co
    • eu.dashboard.novu.co
    • eu.api.novu.co
    • dashboard.novu.co
    • acme.com
    • api.acme.com

    Also links to:

    • liquidjs.com
    • vercel.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NOVU_SECRET_KEY

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

Context cost

Novu Framework Integration loads about 7.2k tokens when it runs, and up to ~27k if it reads all its reference files. Until then it costs about 166 tokens; SKILL.md has 1,921 words of instructions outside code blocks.

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

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 1,921 words (~7,161 tokens).

“Use @novu/framework to build notification workflows in code, alongside your application source. Workflows live in your repo, content is rendered using libraries you already use (React Email, Vue Email, Svelte Email), and a single HTTP endpoint (the Bridge) lets Novu…”

— opening of SKILL.md by novuhq, Custom licence
name
novu-framework-integration

Read the full SKILL.md on GitHub

Files

SKILL.md and 9 other files (references) in docs/.mintlify/skills/framework-integration of novuhq/novu.

  • SKILL.md
  • references/bridge-endpoint.md
  • references/deployment.md
  • references/email-templates.md
  • references/examples.md
  • references/schema-validation.md
  • references/security.md
  • references/studio-and-cli.md
  • references/translations.md
  • references/workflow-and-steps.md

Open the folder on GitHubat commit 8a05b88

Compare with similar skills

Novu Framework Integration 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 Framework Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novu Framework Integration this skillnovuhq/novu40k—~7.2kAutomated safety check: PassCustom licence
GitHub Actions Failure DebuggingLanceMcCarthy/DevOpsExamples172—~312Automated safety check: PassMIT
Code PatternsAedelon/claude-code-blueprint120—~1.2kAutomated safety check: PassCustom licence
GitHub Actions Templatesbartstc/vite-ts-react-template12214 repos~1.9kAutomated safety check: PassMIT
Winui AppLanceMcCarthy/DevOpsExamples1721 repos~2.8kAutomated safety check: PassApache-2.0
Prepare Cloudflare Production DeploymentLubomirGeorgiev/cloudflare-workers-nextjs-saas-template786—~5.9kAutomated safety check: NotesMIT

Similar skills

  • GitHub Actions Failure Debugging

    LanceMcCarthy/DevOpsExamples

    Guide for debugging failing GitHub Actions workflows. An agent skill from LanceMcCarthy/DevOpsExamples.

    172 GitHub stars~312 tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Code Patterns

    Aedelon/claude-code-blueprint

    Reference patterns for REST APIs, pytest/vitest testing, Docker multi-stage builds, GitHub Actions CI/CD, PostgreSQL, TypeScript generics, Python async, and React Server Components.

    120 GitHub stars~1.2k tokensUpdated 7 mo ago
    DevOps & CloudAuto-check passed
  • GitHub Actions Templates

    bartstc/vite-ts-react-template

    Create production-ready GitHub Actions workflows for automated testing, building, and deploying applications.

    122 GitHub starsUsed in 14 repos~1.9k tokens
    DevOps & CloudAuto-check passed
  • Winui App

    LanceMcCarthy/DevOpsExamples

    Bootstrap, develop, and design modern WinUI 3 desktop applications with C and the Windows App SDK using official Microsoft guidance, WinUI Gallery patterns, Windows App SDK samples, and…

    172 GitHub starsUsed in 1 repo~2.8k tokens
    DevOps & CloudAuto-check passed
  • Prepare Cloudflare Production Deployment

    LubomirGeorgiev/cloudflare-workers-nextjs-saas-template

    Source-of-truth runbook for preparing this Vinext Cloudflare Workers SaaS template for production deployment.

    786 GitHub stars~5.9k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: notes
  • Release Flow

    romankurnovskii/BrewMate

    Automate the full application release flow for BrewMate, including committing local changes, bumping version, waiting for GitHub Actions release build, and pushing the in-repo cask update…

    301 GitHub stars~976 tokensUpdated 12 days ago
    DevOps & CloudAuto-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 today
    Auto-check passed
  • Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state.

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

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

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

    40k GitHub stars~1.3k tokensUpdated today
    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 today
    Auto-check passed

Questions about Novu Framework Integration

What does Novu Framework Integration do?

Build code-first notification workflows with @novu/framework. Novu Framework Integration is an agent skill from novuhq/novu. Build code-first notification workflows with @novu/framework.

When should I use Novu Framework Integration?

Novu Framework Integration fits situations like: defining workflows in TypeScript (Zod / JSON Schema / Class Validator); composing channel steps (email; in-app) with action steps (delay; exposing Step Controls for non-technical teammates.

How do I install Novu Framework Integration in Claude Code?

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

How do I install Novu Framework Integration in Codex?

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

Can I use Novu Framework Integration 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-framework-integration -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-framework-integration, .gemini/skills/novu-framework-integration, .github/skills/novu-framework-integration and .opencode/skills/novu-framework-integration in your project.

What does Novu Framework Integration need to run?

Going by SKILL.md and its folder, Novu Framework Integration needs the command-line tools its instructions call (npx and npm) and credentials named NOVU_SECRET_KEY. Our summary lists: Node.js; A credential in NOVU_SECRET_KEY; A credential in YOUR_NOVU_SECRET_KEY.

Does Novu Framework Integration access the network?

SKILL.md names 8 domains. In commands or code: api.novu.co, eu.dashboard.novu.co, eu.api.novu.co, dashboard.novu.co, acme.com and api.acme.com; the agent is likely to contact these when it follows the instructions. As links in the text: liquidjs.com and vercel.com. This is read from the text; nothing was executed.

Is Novu Framework Integration 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 Framework Integration use?

Novu Framework Integration 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 Framework Integration use?

About 7.2k tokens (SKILL.md is roughly 29k 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 20k tokens, read only when the agent opens those files.

What are the alternatives to Novu Framework Integration?

Skills that share tags, products or a category with Novu Framework Integration: GitHub Actions Failure Debugging (LanceMcCarthy/DevOpsExamples, 172 stars), Code Patterns (Aedelon/claude-code-blueprint, 120 stars), GitHub Actions Templates (bartstc/vite-ts-react-template, 122 stars) and Winui App (LanceMcCarthy/DevOpsExamples, 172 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Novu Framework Integration?

novuhq (a GitHub organization) maintains it in novuhq/novu, which has 40,134 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 9, 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.