mirror of https://github.com/getsentry/sentry-for-ai.git synced 2026-09-14 14:28:22 +08:00

Files

T

Daniel Griesser 1dc63862ea feat(browser-sdk): add sentry-browser-sdk skill — vanilla JS, Loader Script, CDN

Adds the sentry-browser-sdk skill, a complete Sentry setup wizard for
browser JavaScript projects that don't use a framework-specific SDK.

## What's included

**SKILL.md (654 lines):**
- Phase 1: Framework detection FIRST — actively redirects React → sentry-react-sdk,
  Next.js → sentry-nextjs-sdk, Vue/Angular/Svelte/Remix/Nuxt/Astro → their docs.
  Only proceeds with @sentry/browser when no framework is detected.
- Three installation paths:
  - Path A (npm): full setup with Sentry.init(), source maps via all four build
    plugins (Vite, webpack, Rollup, esbuild) plus sentry-cli fallback
  - Path B (Loader Script): for WordPress, Shopify, Squarespace, static HTML —
    zero build tooling, lazy/eager modes, sentryOnLoad config, limitations
  - Path C (CDN bundles): 7 named bundle variants with SRI integrity hashes for
    manual script tag installs
- Phase 2: Feature recommendation matrix (Error Monitoring, Tracing, Replay,
  User Feedback, Logging, Profiling) with npm-only callouts for Logging
- Phase 3: Reference dispatch table pointing to references/ subdirectory
- Configuration reference table (all Sentry.init() options)
- Verification section for all three paths
- Phase 4: Backend cross-link detection (Go, Python, Ruby, PHP, .NET, Node.js)
- Troubleshooting table (20+ issues with solutions)

**Router updates:**
- sentry-sdk-setup/SKILL.md: adds sentry-browser-sdk row and routing rule #9
  (vanilla JS, jQuery, WordPress, static HTML → sentry-browser-sdk)
- AGENTS.md: adds sentry-browser-sdk to the SDK Skills table
- SKILL_TREE.md: regenerated via scripts/build-skill-tree.sh (0 errors)

Co-Authored-By: Claude Sonnet 4.6 (Anthropic)

2026-03-03 22:49:34 +01:00

5.3 KiB

Raw Permalink Blame History

Agent Instructions

Project Overview

Sentry plugin for AI coding assistants (Claude Code, Cursor). Provides MCP server integration, slash commands, and skills.

Commit Attribution

AI commits MUST include:

Co-Authored-By: (the agent model's name and attribution byline)

Plugin Structure

commands/               # Slash commands (/seer)
skills/                 # Setup and review skills
.agents/                # Symlinks to commands/ and skills/
.claude-plugin/         # Claude Code plugin metadata
.cursor-plugin/         # Cursor plugin metadata

Skills use YAML frontmatter with allowed-tools — this is required by Cursor and harmless in Claude Code. Keep it in all skill files.

Skills

SDK Skills (Full Platform Bundles)

Skill	Description
`sentry-android-sdk`	Full setup wizard for Android (Jetpack Compose, Views, OkHttp, Room, Fragment, Timber)
`sentry-cocoa-sdk`	Full setup wizard for Apple platforms (iOS, macOS, tvOS, watchOS, visionOS)
`sentry-dotnet-sdk`	Full setup wizard for .NET (ASP.NET Core, MAUI, WPF, WinForms, Azure Functions)
`sentry-go-sdk`	Full setup wizard for Go (net/http, Gin, Echo, Fiber)
`sentry-nestjs-sdk`	Full setup wizard for NestJS (Express, Fastify, GraphQL, Microservices)
`sentry-node-sdk`	Full setup wizard for Node.js, Bun, and Deno (Express, Fastify, Koa, Hapi, Connect)
`sentry-nextjs-sdk`	Full setup wizard for Next.js (App Router + Pages Router)
`sentry-php-sdk`	Full setup wizard for PHP (Laravel, Symfony)
`sentry-python-sdk`	Full setup wizard for Python (Django, Flask, FastAPI, Celery)
`sentry-react-native-sdk`	Full setup wizard for React Native and Expo
`sentry-browser-sdk`	Full setup wizard for Browser JavaScript (vanilla JS, jQuery, WordPress, static sites, Loader Script, CDN)
`sentry-react-sdk`	Full setup wizard for React (Router v5-v7, TanStack, Redux)
`sentry-ruby-sdk`	Full setup wizard for Ruby (Rails, Sinatra, Sidekiq)
`sentry-svelte-sdk`	Full setup wizard for Svelte/SvelteKit

Setup Skills

Skill	Description
`sentry-setup-ai-monitoring`	Instrument OpenAI/Anthropic/Vercel AI/LangChain/Google GenAI
`sentry-otel-exporter-setup`	Setup OTel Collector with Sentry Exporter

Workflow Skills

Skill	Description
`sentry-code-review`	Analyze and resolve Sentry bot comments on GitHub PRs
`sentry-pr-code-review`	Review PRs for issues detected by Seer Bug Prediction
`sentry-fix-issues`	Find and fix Sentry issues using MCP
`sentry-sdk-upgrade`	Upgrade the Sentry JavaScript SDK across major versions
`sentry-create-alert`	Create Sentry alerts using the workflow engine API

Authoring Skills

Skill	Description
`sentry-sdk-skill-creator`	Create a complete SDK skill bundle for any new platform

Commands

Command	Description
`/seer <query>`	Natural language Sentry environment queries

MCP Server

Sentry MCP server configured at https://mcp.sentry.dev/mcp. Two config files exist:

.mcp.json — Claude Code format
mcp.json — Cursor format

Key Conventions

All setup skills must detect platform/SDK before suggesting configuration — never assume
Sentry code review skill only processes comments from sentry[bot], ignores other bots
GitHub CLI (gh) required for PR-related skills
Avoid emojis in skill/command content — keep output platform-neutral

How it works:

3 router skills (always visible in agent metadata): sentry-sdk-setup, sentry-workflow, sentry-feature-setup
All other skills are hidden with disable-model-invocation: true — loaded on-demand when a router points to them
SKILL_TREE.md at repo root is the flat sitemap listing every skill
This keeps startup metadata at ~300 tokens instead of ~1,600+ as the library grows
Tools that don't support disable-model-invocation simply see all skills (same as before)

Categories:

sdk-setup — platform/language SDK setup wizards (router: sentry-sdk-setup)
workflow — debugging, code review, issue management (router: sentry-workflow)
feature-setup — specific feature configuration (router: sentry-feature-setup)
internal — contributor tools, no router

Adding a new skill:

Create skills/<skill-name>/SKILL.md with standard frontmatter
Add category, parent, disable-model-invocation: true to frontmatter
Add breadcrumb as first body line: > [All Skills](../../SKILL_TREE.md) > [Category](../router/SKILL.md) > Skill Name
Add the skill to the parent router's routing table
Run scripts/build-skill-tree.sh to regenerate SKILL_TREE.md and validate
CI validates automatically on every PR

Adding a new category:

When a category exceeds ~10 skills, consider splitting
Create a new router skill with role: router in frontmatter
Update existing skills' category and parent fields
Update this file to document the new category

Validation:

scripts/build-skill-tree.sh — regenerates SKILL_TREE.md, validates all frontmatter, breadcrumbs, and router tables
scripts/build-skill-tree.sh --check — CI mode, fails if SKILL_TREE.md is stale or validation errors exist

5.3 KiB Raw Permalink Blame History