sentry-nextjs-sdk SKILL.md skillA

sentry-nextjs-sdk from pubky/pubky-app is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add pubky/pubky-app/sentry-nextjs-sdk@git:20260507.298cb6e

Pins git:20260507.298cb6e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
pubky/pubky-app
Path
.agents/skills/sentry-nextjs-sdk/SKILL.md
Versions recorded
1
Latest version
git:20260507.298cb6e, committed May 7, 2026
Size
22,740 bytes
Repository stars
26
License
MIT

Full Sentry SDK setup for Next.js. Use when asked to "add Sentry to Next.js", "install @sentry/nextjs", or configure error monitoring, tracing, session replay, logging, profiling, AI monitoring, or crons for Next.js applications. Supports Next.js 13+ with App Router and Pages Router.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

> [All Skills](../../SKILL_TREE.md) > [SDK Setup](../sentry-sdk-setup/SKILL.md) > Next.js SDK

# Sentry Next.js SDK

Opinionated wizard that scans your Next.js project and guides you through complete Sentry setup across all three runtimes: browser, Node.js server, and Edge.

## Invoke This Skill When

- User asks to "add Sentry to Next.js" or "set up Sentry" in a Next.js app
- User wants to install or configure `@sentry/nextjs`
- User wants error monitoring, tracing, session replay, logging, or profiling for Next.js
- User asks about `instrumentation.ts`, `withSentryConfig()`, or `global-error.tsx`
- User wants to capture server actions, server component errors, or edge runtime errors

> **Note:** SDK versions and APIs below reflect current Sentry docs at time of writing (`@sentry/nextjs` ≥8.28.0).
> Always verify against [docs.sentry.io/platforms/javascript/guides/nextjs/](https://docs.sentry.io/platforms/javascript/guides/nextjs/) before implementing.

---

## Phase 1: Detect

Run these commands to understand the project before making any recommendations:

```bash
# Detect Next.js version and existing Sentry
cat package.json | grep -E '"next"|"@sentry/'
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add pubky/pubky-app/sentry-nextjs-sdk@sha256:903aaa08d2178b1f

The line at the top of this page pins the label git:20260507.298cb6e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_to3g6wfe7drtepma.svg)](https://markdownregistry.com/a/art_to3g6wfe7drtepma)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 7, 2026.

versioncommittedcommitsizeaudit
git:20260507.298cb6e latest2026-05-07 298cb6e 22,740 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (22740 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

pubky/pubky-app · 26 stars · license MIT · pushed 2026-11-02 · branch dev

API

GET https://markdownregistry.com/api/v1/artifacts/art_to3g6wfe7drtepma
GET https://markdownregistry.com/api/v1/resolve?ref=pubky/pubky-app/sentry-nextjs-sdk
GET https://markdownregistry.com/api/v1/blob/903aaa08d2178b1f25d02b80c66e804a6329fb86c1a1c8d5a8cf1252b5f3a4a4

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from pubky/pubky-app

pubky-code-review SKILL.md skill
pubky/pubky-app · .agents/skills/pubky-code-review/SKILL.md · Run a local code review of a diff against this repo's architecture rules (AGENTS.md, .greptile/config.json) and quality…
git:20261009.f54b19a · audit A · 26 stars
pubky-staging-invite SKILL.md skill
pubky/pubky-app · .agents/skills/pubky-staging-invite/SKILL.md · Mints a single-use signup token for the Pubky staging homeserver. Use when the user explicitly asks for a new staging…
git:20260915.d786bb4 · audit A · 26 stars
architecture Cursor rule
pubky/pubky-app · .cursor/rules/architecture.mdc · Core architecture rules - layer separation, dependencies, and anti-patterns
git:20260309.80c3cb2 · audit B · 26 stars
commit-message Cursor rule
pubky/pubky-app · .cursor/rules/commit-message.mdc · Enforce conventional commit message format
git:20260309.80c3cb2 · audit B · 26 stars
component-testing Cursor rule
pubky/pubky-app · .cursor/rules/component-testing.mdc · Writing unit tests for UI component rendering
git:20261009.f54b19a · audit B · 26 stars
components Cursor rule
pubky/pubky-app · .cursor/rules/components.mdc · Component development patterns - Shadcn first, atomic design, Figma parity
git:20260309.80c3cb2 · audit B · 26 stars
data-patterns Cursor rule
pubky/pubky-app · .cursor/rules/data-patterns.mdc · Data patterns - composite IDs, streams, TTL, pipes normalization
git:20260915.d786bb4 · audit B · 26 stars
env-variables Cursor rule
pubky/pubky-app · .cursor/rules/env-variables.mdc · Build-time Env and runtime PUBKY_RUNTIME_* configuration rules
git:20260915.d786bb4 · audit A · 26 stars
error-handling Cursor rule
pubky/pubky-app · .cursor/rules/error-handling.mdc · Error handling conventions using AppError across all layers
git:20260915.d786bb4 · audit B · 26 stars
local-first Cursor rule
pubky/pubky-app · .cursor/rules/local-first.mdc · Local-first write patterns and controller naming conventions
git:20260915.d786bb4 · audit B · 26 stars
pwa Cursor rule
pubky/pubky-app · .cursor/rules/pwa.mdc · PWA / service worker — shell-only precache, no data caching, user-consented updates, static offline fallback, manifest…
git:20260918.b35cf7a · audit A · 26 stars
sentry Cursor rule
pubky/pubky-app · .cursor/rules/sentry.mdc · Observability conventions (Sentry + Pulse) — capture funnel, direct-call rule and the Pulse consent gate
git:20260923.a27e420 · audit A · 26 stars

Every file in pubky/pubky-app

Browse by kind, by grade A, or by owner.