When to use it
- Starting a new service or app
- Moving to Sentry from another error tracker
- Fixing missing source maps or releases
What it looks like
Add Sentry to this Next.js app.
find_teamsfind_projectsfind_dsnscreate_team+6 moreNo existing project for this app. Proposed: project "web-dashboard" (platform javascript-nextjs) under team Frontend. After that I will add @sentry/nextjs, the three config files and source map upload with the DSN in SENTRY_DSN. Create the project?
The SKILL.md file
name: sentry-project-setupSet up Sentry for a new app or service by creating or picking the team and project, getting the DSN, and walking through SDK install, release tracking and source maps from Sentry's docs. Use when the user asks to add Sentry to a project, create a Sentry project, or get a DSN.
Steps
- Identify the platform from the user's repo or words, such as Next.js, Django, React Native or Go.
- Check what exists with
find_teams,find_projectsandfind_dsns, to avoid duplicate projects. - If a new project is needed, propose the team, project name and platform. After the user approves, create it with
create_team(only if no team fits) andcreate_project, and adjust settings withupdate_projectwhen asked. Usecreate_dsnonly when the user wants a separate key, for example per environment. - Fetch the setup guide for that platform with
search_docsandget_doc. Follow the current docs, not memory: SDK init, environment, release name, and source maps or debug symbols. - When the repo is open, propose the exact code and config changes. Keep the DSN in an environment variable, not hard-coded.
- Verify by asking the user to trigger a test error, then confirm it arrived with
find_issues.
Report
The project, DSN location and the files changed, plus what remains, such as uploading source maps in CI.
Sentry tools it uses
find_teamsfind_projectsfind_dsnscreate_teamAsks firstcreate_projectAsks firstupdate_projectAsks firstcreate_dsnAsks firstsearch_docsget_docfind_issues
Tool list from Sentry MCP documentation.
FAQ
Does it use current Sentry docs?
Yes. It fetches the setup guide for your platform from Sentry's documentation each time, rather than relying on memory.
Where does the DSN go?
In an environment variable. The skill never hard-codes it in source.