Loading plugin...

sentry-skills · Flowy

README

Sentry Skills

[!NOTE] For skills to help set up Sentry in your project or debug production issues, see https://github.com/getsentry/sentry-for-ai

Agent skills for Sentry employees, following the Agent Skills open format.

Installation

Claude Code

claude plugin marketplace add getsentry/skills
claude plugin install sentry-skills@sentry-skills

If you use claude plugin marketplace add --sparse for this repo, include skills and agents alongside .claude-plugin because the root plugin manifest loads repo-root skills/ and agents/.

Restart Claude Code after installation. Skills activate automatically when relevant.

Update:

claude plugin marketplace update
claude plugin update sentry-skills@sentry-skills

Or run /plugin to open the plugin manager.

Skills Package (skills.sh)

For agents supporting the skills.sh ecosystem:

npx skills add getsentry/skills

Works with Claude Code, Cursor, Cline, GitHub Copilot, and other compatible agents.

Available Skills

Skill	Description
agents-md	Create and maintain concise, reference-backed AGENTS.md and CLAUDE.md files.
blog-writing-guide	Write, review, and improve blog posts for the Sentry engineering blog following Sentry's specific writing standards, voice, and quality bar.
brand-guidelines	Write copy following Sentry brand guidelines.
claude-settings-audit	Analyze a repository to generate recommended Claude Code settings.json permissions.
code-review	Perform code reviews following Sentry engineering practices.
code-simplifier	Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality.
commit	ALWAYS use this skill when committing code changes — never commit directly without it.
create-branch	Create git branches following Sentry naming conventions.
django-access-review	Django access control and IDOR security review.
django-perf-review	Django performance code review.
doc-coauthoring	Guide users through a structured workflow for co-authoring documentation.

Available Subagents

Subagent	Description
code-simplifier	Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality
senpai	Senior engineer and technical mentor for new Sentry hires. Explains infrastructure, architecture, and engineering concepts step-by-step with references

Contributing

Local Development

git clone git@github.com:getsentry/skills.git ~/sentry-skills
claude plugin marketplace add ~/sentry-skills
claude plugin install sentry-skills

If you use claude plugin marketplace add --sparse for this repo, include skills and agents alongside .claude-plugin because the root plugin manifest loads repo-root skills/ and agents/.

Repository Structure

sentry-skills/
├── .claude-plugin/
│   ├── marketplace.json      # Marketplace manifest
│   └── plugin.json           # Root plugin manifest for sentry-skills
├── .agents/
│   └── skills -> ../skills   # Local mirror for agent tooling
├── agents/
│   ├── code-simplifier.md
│   └── senpai.md
├── skills/
│   ├── code-review/
│   │   └── SKILL.md
│   └── commit/
│       └── SKILL.md
├── AGENTS.md                 # Agent-facing documentation
├── CLAUDE.md                 # Symlink to AGENTS.md
└── README.md                 # This file

The canonical skill source for the sentry-skills plugin lives at repo-root skills/. .agents/skills mirrors that tree for local agent tooling, and the root plugin manifest loads repo-root skills/ and agents/.

New skills and materially changed skills should include a root-level SPEC.md alongside SKILL.md.

Creating New Skills

Skills follow the Agent Skills specification. Each skill requires a SKILL.md file with YAML frontmatter.

For repeatable skill-writer evaluation prompts, see skills/skill-writer/EVAL.md.

Skill Template

Create a new directory under skills/:

skills/my-skill/
├── SKILL.md
└── SPEC.md

SKILL.md format:

---
name: my-skill
description: A clear description of what this skill does and when to use it. Include keywords that help agents identify when this skill is relevant.
---

# My Skill Name

## Instructions

Step-by-step guidance for the agent.

## Examples

Concrete examples showing expected input/output.

## Guidelines

- Specific rules to follow
- Edge cases to handle

SPEC.md format:

Use SPEC.md as the maintenance contract for the skill. It should describe intent, scope, trigger context, source/evidence model, reference architecture, evaluation expectations, known limitations, and maintenance notes. Keep runtime instructions in SKILL.md; keep source inventories in SOURCES.md; keep durable examples in references/evidence/.

Naming Conventions

name: 1-64 characters, lowercase alphanumeric with hyphens only
description: Up to 1024 characters, include trigger keywords
Keep SKILL.md under 500 lines; split longer content into reference files

Optional Fields

Field	Description
`license`	License name or path to license file
`compatibility`	Environment requirements (max 500 chars)
`allowed-tools`	Comma-separated list of tools the skill can use
`metadata`	Arbitrary key-value pairs for additional properties

---
name: my-skill
description: What this skill does
license: Apache-2.0
allowed-tools: Read, Grep, Glob
---

Where Skills Belong

Skills should live in the appropriate location based on their scope:

Scope	Location	Example
Global - Used across Sentry	`sentry-skills` plugin	`commit`, `code-review`, `pr-writer`
Domain-specific - Used by a team or domain	Dedicated plugin in this repo (e.g., `infra-skills`)	`gcp-logs`, `terraform-review`
Repo-specific - Only relevant to one repo	The repository itself (`.claude/skills/`)	Project-specific workflows

When deciding where to place a skill:

If most Sentry engineers would benefit, add it to sentry-skills
If only a specific team needs it, create or use a domain-specific plugin
If it only makes sense in one repo, keep it in that repo

Marketplace Structure

This repository is a Claude Code marketplace - a collection of plugins that can be installed independently. The marketplace manifest (.claude-plugin/marketplace.json) lists all available plugins:

{
  "plugins": [
    {
      "name": "sentry-skills",
      "source": "./"
    },
    { "name": "infra-skills", "source": "./plugins/infra-skills" }
  ]
}

Marketplace entries point at a plugin source directory. That source can be a dedicated plugin directory with its own .claude-plugin/plugin.json, or repo root when the root also carries a plugin manifest. The sentry-skills entry in this repo uses repo root as its plugin source so it can keep canonical skills/ and agents/ at top level.

Users can install individual plugins:

# Install just the global skills
claude plugin install sentry-skills@sentry-skills

# Install domain-specific skills
claude plugin install infra-skills@sentry-skills

To add a new domain-specific plugin:

Create plugins/<plugin-name>/.claude-plugin/plugin.json
Add skills under plugins/<plugin-name>/skills/
Register the plugin in .claude-plugin/marketplace.json

Vendoring Skills

We vendor (copy) skills and agents that we use regularly into this repository rather than depending on external sources at runtime. This approach:

Ensures consistency - Everyone on the team uses the same version of each skill
Enables customization - We can adapt skills to Sentry-specific conventions
Improves reliability - No external dependencies that could change or disappear

Attribution

When vendoring a skill or agent from an external source, retain proper attribution:

Add a comment at the top of the file referencing the original source:

<!--
Based on [Original Name] by [Author/Org]:
https://github.com/example/original-source
-->

Include a LICENSE file in the skill directory if the original has specific licensing requirements:
```
skills/vendored-skill/
├── SKILL.md
└── LICENSE      # Original license text
```

Example: code-simplifier

The code-simplifier agent is vendored from Anthropic's official plugins. See the attribution comment at the top of the agent file.

References

License

Apache-2.0

File tree

153

getsentry/skillsView on GitHub ↗

.agents/
  skills
.claude/
.claude-plugin/
  marketplace.json
  plugin.json
  settings.json
.gitignore
agents/
AGENTS.md
  code-simplifier.md
  senpai.md
CLAUDE.md
CONTRIBUTING.md
LICENSE
README.md
skills/
  agents-md/
    SKILL.md
    SOURCES.md
    SPEC.md
  blog-writing-guide/
    SKILL.md
  brand-guidelines/
    SKILL.md
  claude-settings-audit/
    SKILL.md
  code-review/
    SKILL.md
  code-simplifier/
    SKILL.md
  commit/
    SKILL.md
  create-branch/
    SKILL.md
  django-access-review/
    references/
      django-orm.md
      django-views.md
      drf-permissions.md
      tenant-isolation.md
    SKILL.md
  django-perf-review/
    LICENSE
    SKILL.md
  doc-coauthoring/
    SKILL.md
  document-api-endpoint/
    SKILL.md
  find-bugs/
    SKILL.md
  gh-review-requests/
    scripts/
      fetch_review_requests.py
    SKILL.md
  gha-security-review/
    references/
      ai-prompt-injection-via-ci.md
      comment-triggered-commands.md
      credential-escalation.md
      expression-injection.md
      permissions-and-secrets.md
      pwn-request.md
      real-world-attacks.md
      runner-infrastructure.md
      supply-chain.md
    SKILL.md
  iterate-pr/
    scripts/
      fetch_pr_checks.py
      fetch_pr_feedback.py
      monitor_pr_checks.py
      reply_to_thread.py
    SKILL.md
    SPEC.md
  pr-link-issue/
    SKILL.md
  pr-writer/
    EVAL.md
    evals/
      axis.config.json
      scenarios/
        concise-docs-pr.json
    SKILL.md
    SPEC.md
  presentation-creator/
    references/
      chart-patterns.md
      design-system.md
      sentry-glyph.svg
      sentry-logo.svg
    SKILL.md
  prompt-optimizer/
    references/
      core-patterns.md
      meta-optimization-loop.md
      model-family-notes.md
      transformed-examples.md
    SKILL.md
    SOURCES.md
    SPEC.md
  replay-ux-research/
    references/
      output-template.md
      product-areas.md
    SKILL.md
  security-review/
    infrastructure/
      docker.md
    languages/
      javascript.md
      python.md
    LICENSE
    references/
      api-security.md
      authentication.md
      authorization.md
      business-logic.md
      cryptography.md
      csrf.md
      data-protection.md
      deserialization.md
      error-handling.md
      file-security.md
      injection.md
      logging.md
      misconfiguration.md
      modern-threats.md
      ssrf.md
      supply-chain.md
      xss.md
    SKILL.md
  skill-scanner/
    references/
      dangerous-code-patterns.md
      permission-analysis.md
      prompt-injection-patterns.md
    scripts/
      scan_skill.py
    SKILL.md
  skill-writer/
    EVAL.md
    evals/
      axis.config.json
      scenarios/
        iteration-from-bad-output.json
        reference-backed-integration.json
        small-inline-workflow.json
    references/
      authoring-path.md
      claude-argument-substitutions.md
      claude-dynamic-context.md
      claude-frontmatter-invocation.md
      claude-hook-backed.md
      claude-subagent-fork.md
      description-optimization.md
      design-principles.md
      example-documentation-skill.md
      example-hook-backed-skill.md
      example-router-skill.md
      example-subagent-fork-skill.md
      example-workflow-process-skill.md
      execution-shapes.md
      iteration-evidence.md
      iteration-path.md
      layout-argument-driven-skill.md
      layout-asset-template-skill.md
      layout-inline-skill.md
      layout-reference-backed-skill.md
      layout-script-backed-workflow.md
      mode-selection.md
      output-contracts.md
      reference-architecture.md
      registration-validation.md
      skill-evals.md
      source-adaptation.md
      source-discovery.md
      spec-template.md
      structure-troubleshooting.md
      synthesis-path.md
      workflow-orchestrator-workers.md
      workflow-parallel.md
      workflow-plan-validate-execute.md
      workflow-prompt-chaining.md
      workflow-routing.md
      workflow-validation-loops.md
    scripts/
      quick_validate.py
    SKILL.md
    SOURCES.md
    SPEC.md
  sred-project-organizer/
    references/
      project-template.md
      SRED.md
    SKILL.md
  sred-work-summary/
    SKILL.md
  triage-frontend-issues/
    references/
      archive-criteria.md
    SKILL.md
    SPEC.md
  typing-exclusion-worker/
    SKILL.md
warden.toml

sentry-skills

Skills

Agents