Official agent skill

Backend Conventions

by getsentry in getsentry/sentry

Sentry backend conventions for logging, tracing/spans, span/tag attribute naming, metrics tags, and the options system.

OfficialCustom licenceAuto-check passed

Install Backend Conventions

skills CLI
$ npx skills add getsentry/sentry --skill backend-conventions -a claude-code

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

GitHub CLI
$ gh skill install getsentry/sentry backend-conventions --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/getsentry/sentry.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/backend-conventions .claude/skills/backend-conventions && 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
backend-conventions
GitHub stars
45k
Token cost
~1.3k tokens
SKILL.md length
323 words
Files
1
Skills in repo
29
Repo updated
First seen
Licence
Custom licence

At a glance

Sentry backend conventions for logging, tracing/spans, span/tag attribute naming, metrics tags, and the options system.

  • Editing Python in src/ that logs (logger.info/exception)
  • SKILL.md covers Options System, Logging Pattern, Span / Tag Attribute Names and Metrics Tags
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Records metrics (metrics.incr/timing with tags)

What it does

Backend Conventions is an agent skill from getsentry/sentry, published by the product's own GitHub organization. Sentry backend conventions for logging, tracing/spans, span/tag attribute naming, metrics tags, and the options system. Use when adding or editing Python in src/ that logs (logger.info/exception), records metrics (metrics.incr/timing with tags), instruments spans/transactions, calls sentrysdk.settag/setattribute or setspantag/setspandata, or reads registered options with options.get(). Trigger on "add logging", "log an error", "add a metric", "add a span", "instrument tracing", "set an attribute", "add a tag"…

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Sentry and Python. The repository describes itself as: Developer-first error tracking and performance monitoring.

When your agent uses it

  • Editing Python in src/ that logs (logger.info/exception)
  • Records metrics (metrics.incr/timing with tags)
  • Instruments spans/transactions
  • Calls sentrysdk.settag/setattribute

Example prompts

  • “add logging”
  • “log an error”
  • “add a metric”
  • “/backend-conventions”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 87d1203. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python).

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

  • Network

    No URLs in SKILL.md.

    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

Backend Conventions loads about 1.3k tokens when it runs. Until then it costs about 155 tokens; SKILL.md has 323 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 323 words (~1,330 tokens).

“Sentry uses a centralized options system where all options are registered in src/sentry/options/defaults.py with required default values.”

— opening of SKILL.md by getsentry, Custom licence
name
backend-conventions

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/backend-conventions of getsentry/sentry.

Open the folder on GitHubat commit 87d1203

Compare with similar skills

Backend Conventions 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.

Backend Conventions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Backend Conventions this skillgetsentry/sentry45k—~1.3kAutomated safety check: PassCustom licence
Aivisspeech Engine Sentry TriageAivis-Project/AivisSpeech-Engine181—~545Automated safety check: PassLGPL-3.0
Claude Settings Auditgetsentry/skills1k4 repos~3kAutomated safety check: PassApache-2.0
Sentry Python SDKgetsentry/sentry-for-ai268—~4.1kAutomated safety check: PassApache-2.0
Sentry Setup AI MonitoringLiorVainer/data-israel130—~1.8kAutomated safety check: PassApache-2.0
Secret Serializationgetsentry/skills1k—~2.6kAutomated safety check: NotesApache-2.0

Similar skills

  • Aivisspeech Engine Sentry Triage

    Aivis-Project/AivisSpeech-Engine

    AivisSpeech Engine の Sentry issue を調査し、修正すべきエンジン側の不具合と、入力値・ローカル環境・外部サービス由来のノイズを切り分けるためのスキルです。Sentry 側で既知ノイズを永続アーカイブする作業や、voicevoxengine/utility/sentryutility.py と関連テストを更新して既知ノイズを送信前に破棄する作業で使用します。

    181 GitHub stars~545 tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Claude Settings Audit

    getsentry/skills

    Official

    Analyze a repository to generate recommended Claude Code settings.json permissions.

    1k GitHub starsUsed in 4 repos~3k tokens
    DevelopmentAuto-check passed
  • Sentry Python SDK

    getsentry/sentry-for-ai

    Official

    Full Sentry SDK setup for Python. An agent skill from getsentry/sentry-for-ai.

    268 GitHub stars~4.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Sentry Setup AI Monitoring

    LiorVainer/data-israel

    Setup Sentry AI Agent Monitoring in any project. An agent skill from LiorVainer/data-israel.

    130 GitHub stars~1.8k tokensUpdated 4 mo ago
    AI & LLM EngineeringAuto-check passed
  • Secret Serialization

    getsentry/skills

    Official

    Finds secrets, tokens, passwords, and API keys that can leak through generated serialization: Python dataclass repr and asdict, attrs, pydantic modeldump, NamedTuple, JavaScript JSON.stringify and…

    1k GitHub stars~2.6k tokensUpdated 4 days ago
    DevOps & CloudAuto-check: notes
  • Inngest Middleware

    Asymmetric-al/core

    A skill your agent uses when adding cross-cutting concerns to durable functions — structured logging or tracing across all functions, error tracking with Sentry, payload encryption for sensitive…

    382 GitHub stars~2.9k tokensUpdated today
    DevOps & CloudAuto-check passed

More from getsentry/sentry

All 29 skills in this repo
  • Scraps Review

    getsentry/sentry

    Official

    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…

    45k GitHub stars~1.2k tokensUpdated today
    Auto-check: notes
  • Analytics

    getsentry/sentry

    Official

    Instrument and discover analytics events in Sentry's frontend UI.

    45k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Hybrid Cloud Outboxes

    getsentry/sentry

    Official

    Guide for creating and maintaining outbox-based eventually consistent operations in Sentry.

    45k GitHub stars~4.8k tokensUpdated today
    Auto-check passed
  • Hybrid Cloud Rpc

    getsentry/sentry

    Official

    Guide for creating, updating, and deprecating hybrid cloud RPC services in Sentry.

    45k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Hybrid Cloud Test Gen

    getsentry/sentry

    Official

    Generate hybrid cloud tests for the Sentry codebase. An agent skill from getsentry/sentry.

    45k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Lint Fix

    getsentry/sentry

    Official

    Fix violations of an eslintPluginScraps rule across the codebase.

    45k GitHub stars~1k tokensUpdated today
    Auto-check passed

Works with

Questions about Backend Conventions

What does Backend Conventions do?

Sentry backend conventions for logging, tracing/spans, span/tag attribute naming, metrics tags, and the options system. Backend Conventions is an agent skill from getsentry/sentry, published by the product's own GitHub organization. Sentry backend conventions for logging, tracing/spans, span/tag attribute naming, metrics tags, and the options system.

When should I use Backend Conventions?

Backend Conventions fits situations like: editing Python in src/ that logs (logger.info/exception); records metrics (metrics.incr/timing with tags); instruments spans/transactions; calls sentrysdk.settag/setattribute.

How do I install Backend Conventions in Claude Code?

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

How do I install Backend Conventions in Codex?

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

Can I use Backend Conventions 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 getsentry/sentry --skill backend-conventions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/backend-conventions, .gemini/skills/backend-conventions, .github/skills/backend-conventions and .opencode/skills/backend-conventions in your project.

What does Backend Conventions need to run?

SKILL.md names no scripts, command-line tools or credentials: Backend Conventions is instructions for the agent only. Our summary lists: Python 3.

Does Backend Conventions access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Backend Conventions 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. Review the folder before installing.

What licence does Backend Conventions use?

Backend Conventions has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Backend Conventions use?

About 1.3k tokens (SKILL.md is roughly 5.3k 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 Backend Conventions?

Skills that share tags, products or a category with Backend Conventions: Aivisspeech Engine Sentry Triage (Aivis-Project/AivisSpeech-Engine, 181 stars), Claude Settings Audit (getsentry/skills, 1k stars), Sentry Python SDK (getsentry/sentry-for-ai, 268 stars) and Sentry Setup AI Monitoring (LiorVainer/data-israel, 130 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Backend Conventions?

getsentry (a GitHub organization, an official publisher) maintains it in getsentry/sentry, which has 45,495 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 7, 2026.

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