Agent skill

Sentry

by mitsuhiko in mitsuhiko/agent-stuff

Fetch and analyze Sentry issues, events, transactions, and logs.

Apache-2.0Auto-check passedDevelopment

Install Sentry

skills CLI
$ npx skills add mitsuhiko/agent-stuff --skill sentry -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mitsuhiko/agent-stuff sentry --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mitsuhiko/agent-stuff.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sentry .claude/skills/sentry && rm -rf skills-src

Use ~/.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/

Facts

Skill name
sentry
GitHub stars
3.2k
Token cost
~1.8k tokens
SKILL.md length
534 words
Files
7 (incl. scripts)
Skills in repo
16
Repo updated
First seen
Licence
Apache-2.0

At a glance

Fetch and analyze Sentry issues, events, transactions, and logs.

  • Works in 5 steps: Start broad, then narrow down: Use… → Use breadcrumbs: The --breadcrumbs flag… → Look for patterns: Use list-issues.js… → …
  • Tasks that involve Root cause analysis
  • SKILL.md covers Quick Reference, Common Debugging Workflows, Fetch Issue and Fetch Event, plus 4 more sections
  • Runs JavaScript scripts from its folder; reaches sentry.io

What it does

Sentry is an agent skill from mitsuhiko/agent-stuff. Fetch and analyze Sentry issues, events, transactions, and logs. Helps agents debug errors, find root causes, and understand what happened at specific times.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts (for example `lib/auth.js`, `scripts/fetch-event.js` and `scripts/fetch-issue.js`).

It sits in Development, covering Root cause analysis and Debugging. It works with Sentry. The repository describes itself as: These are commands I use with agents, mostly Claude. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Root cause analysis
  • Tasks that involve Debugging

Example prompts

  • “/sentry”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Start broad, then narrow down: Use search-events.js with a time range first, then drill into specific events
  2. Use breadcrumbs: The --breadcrumbs flag on fetch-event.js shows the full history of what happened before an error
  3. Look for patterns: Use list-issues.js --sort freq to find frequently occurring problems
  4. Check related events: If you find one event, look for others with the same transaction name or trace ID
  5. Tags are your friend: Custom tags like thread_id, user_id, request_id help correlate events

What it can do on your machine

Read from SKILL.md and the folder at commit 0865c84. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (JavaScript), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • sentry.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sentry loads about 1.8k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 534 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

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.

Safety

Auto-check passed

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); the scripts in this folder are not scanned.

SKILL.md

The full file from mitsuhiko/agent-stuff at commit 0865c84, republished under its Apache-2.0 licence (© mitsuhiko). 534 words, ~1,783 tokens.

Download SKILL.mdSave it as .claude/skills/sentry/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
sentry
description
Fetch and analyze Sentry issues, events, transactions, and logs. Helps agents debug errors, find root causes, and understand what happened at specific times.

Sentry Skill

Access Sentry data via the API for debugging and investigation. Uses auth token from ~/.sentryclirc.

Quick Reference

TaskCommand
Find errors on a datesearch-events.js --org X --start 2025-12-23T15:00:00 --level error
List open issueslist-issues.js --org X --status unresolved
Get issue detailsfetch-issue.js <issue-id-or-url> --latest
Get event detailsfetch-event.js <event-id> --org X --project Y
Search logssearch-logs.js --org X --project Y "level:error"

Common Debugging Workflows

"What went wrong at this time?"

Find events around a specific timestamp:

bash
# Find all events in a 2-hour window
./scripts/search-events.js --org myorg --project backend \
  --start 2025-12-23T15:00:00 --end 2025-12-23T17:00:00

# Filter to just errors
./scripts/search-events.js --org myorg --start 2025-12-23T15:00:00 \
  --level error

# Find a specific transaction type
./scripts/search-events.js --org myorg --start 2025-12-23T15:00:00 \
  --transaction process-incoming-email
"What errors have occurred recently?"
bash
# List unresolved errors from last 24 hours
./scripts/list-issues.js --org myorg --status unresolved --level error --period 24h

# Find high-frequency issues
./scripts/list-issues.js --org myorg --query "times_seen:>50" --sort freq

# Issues affecting users
./scripts/list-issues.js --org myorg --query "is:unresolved has:user" --sort user
"Get details about a specific issue/event"
bash
# Get issue with latest stack trace
./scripts/fetch-issue.js 5765604106 --latest
./scripts/fetch-issue.js https://sentry.io/organizations/myorg/issues/123/ --latest
./scripts/fetch-issue.js MYPROJ-123 --org myorg --latest

# Get specific event with all breadcrumbs
./scripts/fetch-event.js abc123def456 --org myorg --project backend --breadcrumbs
"Find events with a specific tag"
bash
# Find by custom tag (e.g., thread_id, user_id)
./scripts/search-events.js --org myorg --tag thread_id:th_abc123

# Find by user email
./scripts/search-events.js --org myorg --query "user.email:*@example.com"

Fetch Issue

bash
./scripts/fetch-issue.js <issue-id-or-url> [options]

Get details about a specific issue (grouped error).

Accepts:

  • Issue ID: 5765604106
  • Issue URL: https://sentry.io/organizations/sentry/issues/5765604106/
  • New URL format: https://myorg.sentry.io/issues/5765604106/
  • Short ID: JAVASCRIPT-ABC (requires --org flag)

Options:

  • --latest - Include the latest event with full stack trace
  • --org <org> - Organization slug (for short IDs)
  • --json - Output raw JSON

Output includes:

  • Title, culprit, status, level
  • First/last seen timestamps
  • Event count and user impact
  • Tags and environment info
  • With --latest: stack trace, request details, breadcrumbs, runtime context

Fetch Event

bash
./scripts/fetch-event.js <event-id> --org <org> --project <project> [options]

Get full details of a specific event by its ID.

Options:

  • --org, -o <org> - Organization slug (required)
  • --project, -p <project> - Project slug (required)
  • --breadcrumbs, -b - Show all breadcrumbs (default: last 30)
  • --spans - Show span tree for transactions
  • --json - Output raw JSON

Output includes:

  • Timestamp, project, title, message
  • All tags
  • Context (runtime, browser, OS, trace info)
  • Request details
  • Exception with stack trace
  • Breadcrumbs
  • Spans (with --spans)

Search Events

bash
./scripts/search-events.js [options]

Search for events (transactions, errors) using Sentry Discover.

Time Range Options:

  • --period, -t <period> - Relative time (24h, 7d, 14d)
  • --start <datetime> - Start time (ISO 8601: 2025-12-23T15:00:00)
  • --end <datetime> - End time (ISO 8601)

Filter Options:

  • --org, -o <org> - Organization slug (required)
  • --project, -p <project> - Project slug or ID
  • --query, -q <query> - Discover search query
  • --transaction <name> - Transaction name filter
  • --tag <key:value> - Tag filter (repeatable)
  • --level <level> - Level filter (error, warning, info)
  • --limit, -n <n> - Max results (default: 25, max: 100)
  • --fields <fields> - Comma-separated fields to include

Query Syntax:

transaction:process-*     Wildcard transaction match
level:error               Filter by level
user.email:foo@bar.com    Filter by user
environment:production    Filter by environment
has:stack.filename        Has stack trace

Show full SKILL.md (207 more words)Show less

List Issues

bash
./scripts/list-issues.js [options]

List and search issues (grouped errors) in a project.

Options:

  • --org, -o <org> - Organization slug (required)
  • --project, -p <project> - Project slug (repeatable)
  • --query, -q <query> - Issue search query
  • --status <status> - unresolved, resolved, ignored
  • --level <level> - error, warning, info, fatal
  • --period, -t <period> - Time period (default: 14d)
  • --limit, -n <n> - Max results (default: 25)
  • --sort <sort> - date, new, priority, freq, user
  • --json - Output raw JSON

Query Syntax:

is:unresolved             Status filter
is:assigned               Has assignee
assigned:me               Assigned to current user
level:error               Level filter
firstSeen:+7d             First seen > 7 days ago
lastSeen:-24h             Last seen within 24h
times_seen:>100           Event count filter
has:user                  Has user context
error.handled:0           Unhandled errors only

Search Logs

bash
./scripts/search-logs.js [query|url] [options]

Search for logs in Sentry's Logs Explorer.

Options:

  • --org, -o <org> - Organization slug (required unless URL provided)
  • --project, -p <project> - Filter by project slug or ID
  • --period, -t <period> - Time period (default: 24h)
  • --limit, -n <n> - Max results (default: 100, max: 1000)
  • --json - Output raw JSON

Query Syntax:

level:error              Filter by level (trace, debug, info, warn, error, fatal)
message:*timeout*        Search message text with wildcards
trace:abc123             Filter by trace ID
project:my-project       Filter by project slug

Accepts Sentry URLs:

bash
./scripts/search-logs.js "https://myorg.sentry.io/explore/logs/?project=123&statsPeriod=7d"

Tips for Debugging

  1. Start broad, then narrow down: Use search-events.js with a time range first, then drill into specific events

  2. Use breadcrumbs: The --breadcrumbs flag on fetch-event.js shows the full history of what happened before an error

  3. Look for patterns: Use list-issues.js --sort freq to find frequently occurring problems

  4. Check related events: If you find one event, look for others with the same transaction name or trace ID

  5. Tags are your friend: Custom tags like thread_id, user_id, request_id help correlate events

© mitsuhiko, 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

Files

SKILL.md and 6 other files (scripts) in skills/sentry of mitsuhiko/agent-stuff.

  • SKILL.md
  • lib/auth.js
  • scripts/fetch-event.js
  • scripts/fetch-issue.js
  • scripts/list-issues.js
  • scripts/search-events.js
  • scripts/search-logs.js

Open the folder on GitHubat commit 0865c84

Compare with similar skills

Sentry 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.

Sentry compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sentry this skillmitsuhiko/agent-stuff3.2k—~1.8kAutomated safety check: PassApache-2.0
Sentry Issue Fix Looptixl3d/tixl5.1k—~2.1kAutomated safety check: NotesMIT
Production Error Huntdifferent-ai/openwork24k—~803Automated safety check: PassCustom licence
Debug With Sentrysuperset-sh/superset15k—~828Automated safety check: PassCustom licence
Sentry Fix Issuesgetsentry/sentry-for-ai2683 repos~1.9kAutomated safety check: PassApache-2.0
Sentry Debug Issuegetsentry/sentry-for-ai268—~2.2kAutomated safety check: PassApache-2.0

Similar skills

  • Walks through open Sentry issues for the tooll3 project, latest first, proposing a fix for each and committing them one at a time with your review between.

    5.1k GitHub stars~2.1k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Production Error Hunt

    different-ai/openwork

    Traces an opaque production error in an OpenWork build to its cause using local server logs and Sentry, names the regressing PR and files a report.

    24k GitHub stars~803 tokensUpdated today
    DevelopmentAuto-check passed
  • Debug With Sentry

    superset-sh/superset

    Root-cause a production error with Sentry's evidence before touching code — pull the issue, read the stack trace and breadcrumbs, and separate the crash from its trigger.

    15k GitHub stars~828 tokensUpdated today
    DevelopmentAuto-check passed
  • Sentry Fix Issues

    getsentry/sentry-for-ai

    Official

    Find and fix issues from Sentry using MCP. An agent skill from getsentry/sentry-for-ai.

    268 GitHub starsUsed in 3 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Sentry Debug Issue

    getsentry/sentry-for-ai

    Official

    Debug and fix a Sentry issue — find it (by link, ID, or search), pull full context (stack trace, breadcrumbs, trace, logs), optionally run Seer root-cause / autofix, apply the code fix, and resolve…

    268 GitHub stars~2.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Axiom SRE Investigator

    openclaw/clawhub

    Investigates incidents and production problems with hypothesis-driven debugging, queries Axiom observability data when available, and keeps secrets out of commands and output.

    9.5k GitHub stars~7.1k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from mitsuhiko/agent-stuff

All 16 skills in this repo
  • Anachb

    mitsuhiko/agent-stuff

    Austrian public transport (VOR AnachB) for all of Austria. An agent skill from mitsuhiko/agent-stuff.

    3.2k GitHub starsUsed in 3 repos~1.2k tokens
    Auto-check passed
  • Librarian

    mitsuhiko/agent-stuff

    Cache and refresh remote git repositories under ~/.cache/checkouts/<host/<org/<repo so future references can reuse a local copy.

    3.2k GitHub starsUsed in 1 repo~519 tokens
    Auto-check passed
  • Web Browser

    mitsuhiko/agent-stuff

    Automate and interact with web pages through Chrome or Chromium using the Chrome DevTools Protocol (CDP): navigate, click, fill forms, inspect content, take screenshots, and debug console or network…

    3.2k GitHub stars~1.5k tokensUpdated 11 days ago
    Auto-check: warnings
  • Google Workspace

    mitsuhiko/agent-stuff

    Access Google Workspace APIs (Drive, Docs, Calendar, Gmail, Sheets, Slides, Chat, People) via local helper scripts without MCP.

    3.2k GitHub stars~919 tokensUpdated 11 days ago
    Auto-check passed
  • Oebb Scotty

    mitsuhiko/agent-stuff

    Austrian rail travel planner (ÖBB Scotty). An agent skill from mitsuhiko/agent-stuff.

    3.2k GitHub stars~2.4k tokensUpdated 11 days ago
    Auto-check passed
  • Native Web Search

    mitsuhiko/agent-stuff

    Trigger native web search. An agent skill from mitsuhiko/agent-stuff.

    3.2k GitHub starsUsed in 1 repo~351 tokens
    Auto-check passed

Works with

Categories

Questions about Sentry

What does Sentry do?

Fetch and analyze Sentry issues, events, transactions, and logs. Sentry is an agent skill from mitsuhiko/agent-stuff. Fetch and analyze Sentry issues, events, transactions, and logs.

When should I use Sentry?

Sentry fits situations like: tasks that involve Root cause analysis; tasks that involve Debugging.

How do I install Sentry in Claude Code?

Run `npx skills add mitsuhiko/agent-stuff --skill sentry -a claude-code`. Or copy the skill folder (skills/sentry in mitsuhiko/agent-stuff) into .claude/skills/sentry in your project. Claude Code loads it when a task matches its description.

How do I install Sentry in Codex?

Run `npx skills add mitsuhiko/agent-stuff --skill sentry -a codex`. Or copy the skill folder (skills/sentry in mitsuhiko/agent-stuff) into .agents/skills/sentry in your project. Codex loads it when a task matches its description.

Can I use Sentry in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mitsuhiko/agent-stuff --skill sentry -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, .gemini/skills/sentry, .github/skills/sentry and .opencode/skills/sentry in your project.

What does Sentry need to run?

Going by SKILL.md and its folder, Sentry needs JavaScript for the scripts in its folder. Our summary lists: Node.js.

Does Sentry access the network?

SKILL.md names 1 domain. In commands or code: sentry.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Sentry safe to install?

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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Sentry use?

Sentry is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sentry use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sentry?

Skills that share tags, products or a category with Sentry: Sentry Issue Fix Loop (tixl3d/tixl, 5.1k stars), Production Error Hunt (different-ai/openwork, 24k stars), Debug With Sentry (superset-sh/superset, 15k stars) and Sentry Fix Issues (getsentry/sentry-for-ai, 268 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sentry?

mitsuhiko (a GitHub user) maintains it in mitsuhiko/agent-stuff, which has 3,177 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on September 27, 2026.

Source: mitsuhiko/agent-stuff on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.