Code Design Rationale Investigator
cursor/plugins
Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.
Decide which Sentry signal to reach for when instrumenting code — error, span, span attribute, log, or metric.
$ npx skills add getsentry/sentry-for-ai --skill sentry-instrumentation-guide -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install getsentry/sentry-for-ai sentry-instrumentation-guide --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/getsentry/sentry-for-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills-legacy/sentry-instrumentation-guide .claude/skills/sentry-instrumentation-guide && rm -rf skills-srcUse ~/.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/
Install the "sentry-instrumentation-guide" agent skill from https://github.com/getsentry/sentry-for-ai/tree/main/skills-legacy/sentry-instrumentation-guide into .claude/skills/sentry-instrumentation-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sentry-instrumentation-guide", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/getsentry/sentry-for-ai/tree/main/skills-legacy/sentry-instrumentation-guideType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add getsentry/sentry-for-ai --skill sentry-instrumentation-guide -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install getsentry/sentry-for-ai sentry-instrumentation-guide --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/getsentry/sentry-for-ai.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills-legacy/sentry-instrumentation-guide .agents/skills/sentry-instrumentation-guide && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "sentry-instrumentation-guide" agent skill from https://github.com/getsentry/sentry-for-ai/tree/main/skills-legacy/sentry-instrumentation-guide into .agents/skills/sentry-instrumentation-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sentry-instrumentation-guide", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add getsentry/sentry-for-ai --skill sentry-instrumentation-guide -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install getsentry/sentry-for-ai sentry-instrumentation-guide --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/getsentry/sentry-for-ai.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills-legacy/sentry-instrumentation-guide .cursor/skills/sentry-instrumentation-guide && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "sentry-instrumentation-guide" agent skill from https://github.com/getsentry/sentry-for-ai/tree/main/skills-legacy/sentry-instrumentation-guide into .cursor/skills/sentry-instrumentation-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sentry-instrumentation-guide", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/getsentry/sentry-for-ai.git --path skills-legacy/sentry-instrumentation-guide--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add getsentry/sentry-for-ai --skill sentry-instrumentation-guide -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install getsentry/sentry-for-ai sentry-instrumentation-guide --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/getsentry/sentry-for-ai.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills-legacy/sentry-instrumentation-guide .gemini/skills/sentry-instrumentation-guide && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "sentry-instrumentation-guide" agent skill from https://github.com/getsentry/sentry-for-ai/tree/main/skills-legacy/sentry-instrumentation-guide into .gemini/skills/sentry-instrumentation-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sentry-instrumentation-guide", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install getsentry/sentry-for-ai sentry-instrumentation-guideInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add getsentry/sentry-for-ai --skill sentry-instrumentation-guide -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/getsentry/sentry-for-ai.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills-legacy/sentry-instrumentation-guide .github/skills/sentry-instrumentation-guide && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "sentry-instrumentation-guide" agent skill from https://github.com/getsentry/sentry-for-ai/tree/main/skills-legacy/sentry-instrumentation-guide into .github/skills/sentry-instrumentation-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sentry-instrumentation-guide", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add getsentry/sentry-for-ai --skill sentry-instrumentation-guide -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install getsentry/sentry-for-ai sentry-instrumentation-guide --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/getsentry/sentry-for-ai.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills-legacy/sentry-instrumentation-guide .opencode/skills/sentry-instrumentation-guide && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "sentry-instrumentation-guide" agent skill from https://github.com/getsentry/sentry-for-ai/tree/main/skills-legacy/sentry-instrumentation-guide into .opencode/skills/sentry-instrumentation-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sentry-instrumentation-guide", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
sentry-instrumentation-guideDecide which Sentry signal to reach for when instrumenting code — error, span, span attribute, log, or metric.
Sentry Instrumentation Guide is an agent skill from getsentry/sentry-for-ai, published by the product's own GitHub organization. Decide which Sentry signal to reach for when instrumenting code — error, span, span attribute, log, or metric. Use when adding instrumentation and unsure whether something should be a log vs a span vs a metric, when deciding "what to instrument where", when reviewing instrumentation for gaps, or when a coding agent needs a rule for choosing between errors, traces, logs, and metrics. This skill decides WHAT to emit; the sentry--sdk skills handle HOW to set each pillar up.
Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/choosing-signals.md` and `references/instrumentation-examples.md`).
It works with Sentry. The repository describes itself as: Teach your AI coding assistant how to use Sentry - setup, debugging, alerts, and more. The licence is Apache-2.0.
Read from SKILL.md and the folder at commit d8fd106. It shows what the files ask for, not the result of running them.
Pre-approves these tools, so the agent can use them without asking each time:
ReadGrepGlobFrom allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Links to these hosts (documentation or services it may open):
docs.sentry.ioFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Sentry Instrumentation Guide loads about 2k tokens when it runs, and up to ~6.2k if it reads all its reference files. Until then it costs about 126 tokens; SKILL.md has 1,063 words of instructions outside code blocks.
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.
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.
The full file from getsentry/sentry-for-ai at commit d8fd106, republished under its Apache-2.0 licence (© getsentry). 1,063 words, ~2,000 tokens.
.claude/skills/sentry-instrumentation-guide/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.All Skills > Feature Setup > Instrumentation Guide
Errors, traces, logs, and metrics are the four kinds of telemetry most apps run on, and they overlap enough that the choice is rarely obvious. You can stuff context into a span attribute instead of logging it. You can count log lines instead of emitting a metric. You can add a duration to a log and call it a span.
But each signal exists because it answers a different question and feeds a different workflow once it lands. Reaching for the wrong one means the data is technically there but useless for the job you actually have later. This skill is the decision framework: given a value or an event in front of you, which signal should carry it, and why.
It decides what to emit. For how to turn each pillar on for a given stack, hand off to the
sentry-*-sdk skills and sentry-setup-ai-monitoring.
Important: The SDK APIs and code samples here are illustrative. Verify exact signatures and
minimum versions against docs.sentry.io and the relevant sentry-*-sdk
skill before implementing.
| Signal | The question it answers | Docs |
|---|---|---|
| Errors | "What just broke?" — a stack trace and exception type, grouped into a deduplicated Issue that gets assigned and tracked to resolution. If your code threw, it's an error. | Issues |
| Traces | "Did the request flow the way it was supposed to?" — a waterfall of timed spans. Mostly auto-instrumented. | Trace Explorer |
| Logs | "What was true at this point in the code, and why?" — the system's state at one moment as a structured event: config, flags, inputs/outputs, the decision that was made. | Logs |
| Metrics | "How's this trending over time?" — counters, gauges, distributions you can slice by attribute and chart, alert on, or compare across a deploy. | Metrics |
A useful mental split: a log is one request's story (the needle), a metric is the aggregate (whether the haystack is normal), a trace is where the time went, and an error is the thing that needs a stack trace and an owner.
Use this as a gut check:
| What you want to know | Reach for |
|---|---|
| Something crashed, show the stack trace | Error |
| How long did this take? Which step is slow? | Traces / Spans |
| Did the request flow through the steps I expected? | Traces / Spans |
| What was the state when the code made this decision? | Log |
| What did this function receive and return? | Log |
| How often does X happen? Is the rate normal? | Metric |
| Did something change after the deploy? | Metric |
The same value can legitimately appear in more than one signal. These four tiebreakers cover almost
every real case. (Full reasoning, gotchas, and the "why not just log everything / emit one wide
event?" arguments live in references/choosing-signals.md.)
candidate_count on the span to read one request, recommendations.served as a
metric to watch the rate.logger.warning(exc_info=True) keeps the trace in logs without creating noise in the error feed.Each signal's retention falls out of the question it answers:
traces_sample_rate (higher in dev, lower in production).before_send_log and before_send_metric. This is the point: the whole reason for a log is to
find the one rare request that went sideways, and you can't find what you sampled away.(For the exact sampling and filtering config in your language, see the matching SDK skill's
references/tracing.md and references/metrics.md.)
Because all four signals come from one SDK, they share a trace_id and correlate on their own —
every log and metric is tied to its trace, so you can drill from a metric spike straight into the
samples behind it.
Roughly 80% of spans are auto-instrumented by your framework and database integrations — you write almost none of them. The deliberate work is the other 20%: a span attribute or two to enrich the flow, a decision-point log, and a metric, placed at the spots where your code makes a choice worth questioning later.
references/instrumentation-examples.md walks through a
single request handler instrumented end to end, in both Python and JavaScript/TypeScript,
showing the span attribute, the log, and the metric side by side on the same decision.
This skill tells you what to emit. To actually wire a pillar up:
sentry-<platform>-sdk
skill (e.g. sentry-python-sdk, sentry-nextjs-sdk, sentry-node-sdk). Each has per-feature
reference files for tracing, logging, metrics, and more.sentry-setup-ai-monitoring.Logs and metrics are the two pillars most projects haven't turned on yet, and both are included on every plan. If they aren't enabled, route to the SDK skill first, then come back here to decide what to put where.
© getsentry, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 2 other files (references) in skills-legacy/sentry-instrumentation-guide of getsentry/sentry-for-ai.
Open the folder on GitHubat commit d8fd106
Sentry Instrumentation Guide 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Sentry Instrumentation Guide this skillgetsentry/sentry-for-ai | 268 | — | ~2k | Automated safety check: Pass | Apache-2.0 | |
| Code Design Rationale Investigatorcursor/plugins | 10k | 9 repos | ~2.6k | Automated safety check: Pass | None | |
| Node Backend Development Guidelinesdiet103/claude-code-infrastructure-showcase | 10k | 2 repos | ~2k | Automated safety check: Pass | MIT | |
| Scraps Reviewgetsentry/sentry | 45k | — | ~1.2k | Automated safety check: Notes | Custom licence | |
| Sentry v8 Error Trackingdiet103/claude-code-infrastructure-showcase | 10k | 2 repos | ~2.3k | Automated safety check: Notes | MIT | |
| Create Pull Request with Work Item IDmakeplane/plane | 60k | — | ~824 | Automated safety check: Pass | AGPL-3.0 |
cursor/plugins
Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.
diet103/claude-code-infrastructure-showcase
Sets layered architecture and coding rules for Node.js, Express and TypeScript microservices, covering routes, controllers, services, repositories, Prisma, Sentry and Zod.
getsentry/sentry
Filter large Sentry Scraps design-system migration PRs for review by separating mechanical import-path changes, generated baseline updates, snapshot mocks, and pure renames from substantive…
diet103/claude-code-infrastructure-showcase
Enforces that every error in a service is captured to Sentry v8, with patterns for controllers, routes, cron jobs and database performance spans instead of console logging alone.
makeplane/plane
Opens a pull request for the current branch using the repo's template, a work item ID in the title and a description filled in from the actual diff.
getsentry/sentry
Instrument and discover analytics events in Sentry's frontend UI.
getsentry/sentry-for-ai
Full Sentry SDK setup for Elixir. An agent skill from getsentry/sentry-for-ai.
getsentry/sentry-for-ai
Full Sentry SDK setup for Go. An agent skill from getsentry/sentry-for-ai.
getsentry/sentry-for-ai
Full Sentry SDK setup for Next.js. An agent skill from getsentry/sentry-for-ai.
getsentry/sentry-for-ai
Full Sentry SDK setup for PHP. An agent skill from getsentry/sentry-for-ai.
getsentry/sentry-for-ai
Full Sentry SDK setup for Python. An agent skill from getsentry/sentry-for-ai.
getsentry/sentry-for-ai
Full Sentry SDK setup for React Router Framework mode. An agent skill from getsentry/sentry-for-ai.
Works with
Decide which Sentry signal to reach for when instrumenting code — error, span, span attribute, log, or metric. Sentry Instrumentation Guide is an agent skill from getsentry/sentry-for-ai, published by the product's own GitHub organization. Decide which Sentry signal to reach for when instrumenting code — error, span, span attribute, log, or metric.
Sentry Instrumentation Guide fits situations like: adding instrumentation and unsure whether something should be a log vs a span vs a metric; deciding what to instrument where; reviewing instrumentation for gaps; A coding agent needs a rule for choosing between errors.
Run `npx skills add getsentry/sentry-for-ai --skill sentry-instrumentation-guide -a claude-code`. Or copy the skill folder (skills-legacy/sentry-instrumentation-guide in getsentry/sentry-for-ai) into .claude/skills/sentry-instrumentation-guide in your project. Claude Code loads it when a task matches its description.
Run `npx skills add getsentry/sentry-for-ai --skill sentry-instrumentation-guide -a codex`. Or copy the skill folder (skills-legacy/sentry-instrumentation-guide in getsentry/sentry-for-ai) into .agents/skills/sentry-instrumentation-guide in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add getsentry/sentry-for-ai --skill sentry-instrumentation-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sentry-instrumentation-guide, .gemini/skills/sentry-instrumentation-guide, .github/skills/sentry-instrumentation-guide and .opencode/skills/sentry-instrumentation-guide in your project.
SKILL.md names no scripts, command-line tools or credentials: Sentry Instrumentation Guide is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Glob.
SKILL.md names 1 domain. As links in the text: docs.sentry.io. This is read from the text; nothing was executed.
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.
Sentry Instrumentation Guide is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 2k tokens (SKILL.md is roughly 8k 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 4.2k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Sentry Instrumentation Guide: Code Design Rationale Investigator (cursor/plugins, 10k stars), Node Backend Development Guidelines (diet103/claude-code-infrastructure-showcase, 10k stars), Scraps Review (getsentry/sentry, 45k stars) and Sentry v8 Error Tracking (diet103/claude-code-infrastructure-showcase, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
getsentry (a GitHub organization, an official publisher) maintains it in getsentry/sentry-for-ai, which has 268 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 7, 2026.
Source: getsentry/sentry-for-ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.