⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
agents-md
Creates and maintains concise AGENTS.md and CLAUDE.md project instruction files. Use when asked to create AGENTS.md, update AGENTS.md, maintain agent docs, set up CLAUDE.md, document repository agent conventions, or keep coding-agent instructions minimal and reference-backed.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// 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. |
| document-api-endpoint | Document and type a Sentry API endpoint with drf-spectacular OpenAPI schema — write/fix @extend_schema, specify response TypedDicts, type parameters, fix type drift, and promote to PUBLIC. |
| find-bugs | Find bugs, security vulnerabilities, and code quality issues in local branch changes. |
| gh-review-requests | Fetch unread GitHub notifications for open PRs where review is requested from a specified team or opened by a team member. |
| gha-security-review | GitHub Actions security review for workflow exploitation vulnerabilities. |
| iterate-pr | Iterate on a PR until CI passes and actionable review feedback is addressed. |
| presentation-creator | Create data-driven presentation slides using React, Vite, and Recharts with Sentry branding. |
| pr-link-issue | Append a GitHub issue link and its Linear ticket to the current PR's description. |
| pr-writer | Create, refresh, and rewrite pull request titles and descriptions following Sentry conventions. |
| prompt-optimizer | Optimize prompts with evals, model-family adapters, and exact external context references. |
| secret-serialization | Find secrets and tokens that leak through generated serialization such as dataclass repr, asdict, model_dump, JSON.stringify, logs, and tracing spans. |
| security-review | Security code review for vulnerabilities. |
| skill-scanner | Scan agent skills for security issues. |
| skill-writer | Canonical workflow to synthesize, create, and iteratively improve agent skills for this repository. |
| sred-project-organizer | Take a list of projects and their related documentation, and organize them into the SRED format for submission. |
| sred-work-summary | Go back through the previous year of work and create a Notion doc that groups relevant links into projects that can then be documented as SRED projects. |
| triage-frontend-issues | Triage the Sentry javascript project queue by archiving non-actionable noise (third-party libs, browser quirks, transient 5xx, test traffic) with untilEscalating after user approval. |
| typing-exclusion-worker | Python typing exclusion worker: remove assigned mypy exclusion modules in small scoped batches, fix typing issues, run validation, and produce a structured completion summary. |
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 [email protected]: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
// HOW IT'S BUILT
KEY FILES