skills.rest
novuhq
novuhqOFFICIAL
Explore all skills by this author →
Website𝕏@novuhqGitHub

novu-prepare-pr

Prepares Novu feature branches for pull requests with quality passes, CI triage, and review handling.

39.7k|4.4k|Updated Aug 26, 2021
Search Tags:#Git Workflow#commit hygiene#novu#ci triage#Merge#Code review#Pull request
One-click install
npx skills add https://github.com/novuhq/novu --skill novu-prepare-pr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: novu-prepare-pr
Source: https://github.com/novuhq/novu/tree/main/.cursor/skills/novu-prepare-pr
Command: npx skills add https://github.com/novuhq/novu --skill novu-prepare-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After finishing feature work on a Novu branch, developers still face a long checklist before merge: cleaning the diff, running quality and security passes, formatting commits, opening the PR against next, triaging failing CI checks, and addressing review comments. This Skill orchestrates that entire post-implementation workflow so nothing is missed.

Core Features & Use Cases

  • Structured PR prep workflow: Nine tracked steps covering scope sanity, quality passes (code quality review and deslop), conditional multi-tenant security checks, local validation, commit hygiene, and PR creation via gh.
  • CI triage and review feedback: Dispatches parallel ci-investigator subagents per failing check, distinguishes deterministic failures from flakes, and processes unresolved PR review threads with minimal in-scope fixes.
  • Merge-ready verification: Confirms green CI, resolved threads, Linear ticket linkage, and enterprise submodule cross-linked PRs before declaring done.
  • Use Case: After implementing a new API endpoint on branch cursor/add-endpoint, invoke this Skill to run the security checklist for tenant scoping, build @novu/api-service, open a PR against next titled fix(api-service): ... fixes NV-1234, and iterate on CI failures until merge-ready.

Quick Start

Prepare my current feature branch as a pull request against next and triage any failing CI checks.

Frequently Asked Questions about novu-prepare-pr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prepare a Novu feature branch for a pull request?▼

Run this Skill after implementation is complete. It walks through nine steps: diff sanity, quality passes, security checks, local validation, commit hygiene, PR creation against the next branch, CI triage, review comments, and a merge-ready check.

How to triage failing CI checks on a Novu pull request?▼

The Skill dispatches one ci-investigator subagent per failing check in parallel. Deterministic high-confidence failures like TypeScript build errors get fixed, validated locally, committed, and pushed, while flakes or unrelated failures are reported without guess-fixes.

What commit message format does Novu use for PRs?▼

Commits follow the format type(scope): concise why fixes NV-XXX, with scopes like dashboard, api-service, worker, or shared. PR titles mirror this pattern and must link the Linear ticket, with next as the base branch.

When is the multi-tenant security check required in Novu PRs?▼

The security checklist is required when the PR touches API or Worker code and the DAL. It verifies queries are scoped by _organizationId and _environmentId, shared upstream keys are never exposed, and quota counters are tenant-scoped.

Does this Skill handle Novu enterprise submodule changes?▼

Yes. When the enterprise/ directory changes, the Skill requires opening matching PRs in both repositories and cross-linking the PR bodies. It explicitly avoids fixing submodule sync tests in the main repo.

When should I not use this PR preparation workflow?▼

Do not use it during active feature implementation or to expand scope, since it runs only after code is complete. Tiny explicitly-scoped hotfixes can skip or shorten the quality passes, and it never starts new feature work.

Related Skills

Explore More Software Engineering Skills→
prismaprisma
47.6k

create-pr

Creates GitHub pull requests with Linear-ticket titles and decision-led narrative descriptions.

Official
Advanced
Brave-LabsBrave-Labs

Dev10x-qa-self

Run headless Playwright QA tests on staging and upload evidence to Linear.

Official
Advanced
paulbrittainpaulbrittain

thermo-nuclear-code-quality-review

Audit pull request implementations for maintainability and structural regressions.

Community
Advanced
amotion-aiamotion-ai

pr

Create GitHub pull requests with summaries, test plans, and risk assessments.

Official
Intermediate