openai-sentry — скилл для Claude Code: что делает и как установить
Скилл openai-sentry для Claude Code читает задачи и события Sentry через API и сводит ошибки production к краткому отчёту. Проверяет состояние проекта без изменений в Sentry.
Apache-2.0 ★ 540 обновлён 2026-07-14
/plugin marketplace add trailofbits/skills-curated
/plugin install openai-sentry@skills-curatedЧто делает openai-sentry
Скилл использует scripts/sentry_api.py для запросов к Sentry: показывает список задач, подробности задачи и связанные события. Запросы только на чтение; результаты можно фильтровать по периоду, окружению и поисковой строке. Для списка задач выводятся, среди прочего, статус, время появления и число событий, а личные данные в ответе скрываются.
Перед запуском задайте локально переменную SENTRY_AUTH_TOKEN с токеном, у которого есть права чтения. По умолчанию используются период 24h, окружение prod и лимит 20 результатов; максимум — 50. Скрипт обрабатывает страницы результатов и повторяет запрос один раз при временной ошибке. Без токена к Sentry обратиться не получится, а сырые трассировки стека и токены скилл не выводит.
Какие задачи решает
- найти открытые задачи Sentry за период
- посмотреть события, связанные с задачей
- свести недавние production-ошибки в список
- проверить основные показатели здоровья Sentry
Примеры запросов агенту
- Покажи открытые задачи Sentry для
your-orgиyour-projectза24h. - Найди события для задачи
ABC-123и кратко опиши окружение и время. - Составь список последних production-ошибок проекта в Sentry.
Как установить openai-sentry
1Через маркетплейс плагинов
/plugin marketplace add trailofbits/skills-curated/plugin install openai-sentry@skills-curatedКоманда ставит плагин openai-sentry целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add trailofbits/skills-curated --skill openai-sentry -a claude-code3Вручную: положить файлы
~/.claude/skills/openai-sentry/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/openai-sentry/
1Через Skills CLI (Vercel)
npx skills add trailofbits/skills-curated --skill openai-sentry -a codex2Вручную: положить файлы
.agents/skills/openai-sentry/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add trailofbits/skills-curated --skill openai-sentry -a cursor2Вручную: положить файлы
.cursor/skills/openai-sentry/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install trailofbits/skills-curated plugins/openai-sentry/skills/openai-sentry2Вручную: положить файлы
.github/skills/openai-sentry/SKILL.md1Через Skills CLI (Vercel)
npx skills add trailofbits/skills-curated --skill openai-sentry -a gemini-cli2Командой платформы
gemini skills install https://github.com/trailofbits/skills-curated --path plugins/openai-sentry/skills/openai-sentryВручную: положить файлы
.devin/skills/openai-sentry/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об openai-sentry
Как установить openai-sentry в Claude Code?
Выполните команды по порядку: /plugin marketplace add trailofbits/skills-curated, затем /plugin install openai-sentry@skills-curated.
Что делает openai-sentry?
Он читает задачи и события Sentry через API, а затем выводит сводку по ошибкам и данным проекта. Запросы доступны только для чтения.
Какой токен нужен для работы openai-sentry?
Нужен SENTRY_AUTH_TOKEN с правами чтения, например project:read и event:read. Задайте переменную локально: скилл не должен выводить токен или просить прислать его в чат.
Исходный текст
SKILL.md · Apache-2.0
---
name: openai-sentry
description: Use when the user asks to inspect Sentry issues or events, summarize recent production errors,
or pull basic Sentry health data via the Sentry API; perform read-only queries with the bundled script
and require `SENTRY_AUTH_TOKEN`. Originally from OpenAI's curated skills catalog.
allowed-tools:
- Bash
- Read
- Grep
- Glob
- Write
- Edit
---
# Sentry (Read-only Observability)
## Quick start
- If not already authenticated, ask the user to provide a valid `SENTRY_AUTH_TOKEN` (read-only scopes such as `project:read`, `event:read`) or to log in and create one before running commands.
- Set `SENTRY_AUTH_TOKEN` as an env var.
- Optional defaults: `SENTRY_ORG`, `SENTRY_PROJECT`, `SENTRY_BASE_URL`.
- Defaults: org/project `{your-org}`/`{your-project}`, time range `24h`, environment `prod`, limit 20 (max 50).
- Always call the Sentry API (no heuristics, no caching).
If the token is missing, give the user these steps:
1. Create a Sentry auth token: https://sentry.io/settings/account/api/auth-tokens/
2. Create a token with read-only scopes such as `project:read`, `event:read`, and `org:read`.
3. Set `SENTRY_AUTH_TOKEN` as an environment variable in their system.
4. Offer to guide them through setting the environment variable for their OS/shell if needed.
- Never ask the user to paste the full token in chat. Ask them to set it locally and confirm when ready.
## Core tasks (use bundled script)
Use `scripts/sentry_api.py` for deterministic API calls. It handles pagination and retries once on transient errors.
Scripts and references are located under `{baseDir}/`.
## API requirements
Always use these endpoints (GET only):
- List issues: `/api/0/projects/{org_slug}/{project_slug}/issues/`
- Issue detail: `/api/0/issues/{issue_id}/`
- Events for issue: `/api/0/issues/{issue_id}/events/`
- Event detail: `/api/0/projects/{org_slug}/{project_slug}/events/{event_id}/`
## Inputs and defaults
- `org_slug`, `project_slug`: default to `{your-org}`/`{your-project}` (avoid non-prod orgs).
- `time_range`: default `24h` (pass as `statsPeriod`).
- `environment`: default `prod`.
- `limit`: default 20, max 50 (paginate until limit reached).
- `search_query`: optional `query` parameter.
- `issue_short_id`: resolve via list-issues query first.
## Output formatting rules
- Issue list: show title, short_id, status, first_seen, last_seen, count, environments, top_tags; order by most recent.
- Event detail: include culprit, timestamp, environment, release, url.
- If no results, state explicitly.
- Redact PII in output (emails, IPs). Do not print raw stack traces.
- Never echo auth tokens.
## Golden test inputs
- Org: `{your-org}`
- Project: `{your-project}`
- Issue short ID: `{ABC-123}`
Example prompt: “List the top 10 open issues for prod in the last 24h.”
Expected: ordered list with titles, short IDs, counts, last seen.
## When to Use
<!-- TODO: review -->
## When NOT to Use
<!-- TODO: review -->
© OpenAI · Apache-2.0 · trailofbits/skills-curated