Add a skill that draws flat-editorial flowchart illustrations for
engineering blog posts. It bundles the design tokens and markup
primitives of the style, plus scripts/flowfig.py, which renders a
Mermaid flowchart subset into that markup and exports PNG through
headless Chrome. The Rubik latin subset ships under assets/fonts with
its OFL license so output needs no network.
Register the skill in the README table, .claude/settings.json and the
claude-settings-audit allowlist.
Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XQqb2CLHz4F89Utoqrq5QM
pr-writer now steers agents toward reviewer-facing cover notes instead
of block-style generated changelogs. The body guidance defaults to short
natural prose, uses structure only when the change shape needs it, and
keeps issue-reference syntax out of copyable examples.
The hard safeguards stay focused on privacy, verified issue references,
and avoiding generated tool attribution. The refreshed examples show the
style we want agents to produce, and the structural skill validator
still passes.
Co-authored-by: OpenAI Codex <noreply@openai.com>
Adds a new skill that triages the unresolved queue in the Sentry
`javascript` project by archiving non-actionable noise (third-party
library frames, browser API permission errors, transient backend 5xx,
test/synthetic traffic, customer-environment proxy interference, and
single-event flukes).
The skill is intentionally narrow: only archives (never resolves or
assigns), always uses `ignoreMode=untilEscalating`, always attaches a
category-tagged reason, and never mutates without an explicit user
`apply` reply. The category taxonomy lives in
`references/archive-criteria.md` with positive signals, negative
criteria, and a decision matrix.
Registers the skill in README, `.claude/settings.json`, and the
`claude-settings-audit` allowlist.
Adds a new skill that triages the unresolved queue in the Sentry
`javascript` project by archiving non-actionable noise (third-party
library frames, browser API permission errors, transient backend 5xx,
test/synthetic traffic, customer-environment proxy interference, and
single-event flukes).
The skill is intentionally narrow: only archives (never resolves or
assigns), always uses `ignoreMode=untilEscalating`, always attaches a
category-tagged reason, and never mutates without an explicit user
`apply` reply. The category taxonomy lives in
`references/archive-criteria.md` with positive signals, negative
criteria, and a decision matrix.
Registers the skill in README, `.claude/settings.json`, and the
`claude-settings-audit` allowlist.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds a new skill that appends a Sentry-style '#### Issues' block to a PR
description, referencing both the GitHub issue and the Linear ticket
resolved from the issue's linear-linkback comment.
Co-authored-by: Neel Shah <neel.shah@sentry.io>
Make `iterate-pr` stop treating draft/no-checks states and human review
gates as pending CI. The skill now reports those non-actionable states
explicitly while continuing to poll and fix actionable CI failures and
high/medium review feedback.
**Check Monitoring**
`fetch_pr_checks.py` now includes draft/review metadata and separates
actionable pending checks from human gates. `monitor_pr_checks.py` emits
explicit stop markers for no-checks, draft no-checks, and
review-gate-only states.
**Runtime Guidance**
Compress the runtime skill docs into tables and checklists, and add
`SPEC.md` to keep the scope focused on CI iteration rather than merge
readiness.
---------
Co-authored-by: OpenAI Codex <codex@openai.com>
Tighten the agents-md and prompt-optimizer skills around concise,
reference-backed guidance. AGENTS.md generation now enumerates exact
external files for specs, docs, and policies, while prompt optimization
captures external context before rewriting prompts.
**Skill maintenance metadata**
Adds SPEC.md and SOURCES.md for agents-md, plus SPEC.md for
prompt-optimizer, so material behavior changes have maintenance
contracts and provenance.
**Prompt guidance**
Adds exact external context inventory rules to prompt-optimizer and
compacts the core/reference examples to keep runtime prose smaller.
Co-authored-by: Codex <noreply@openai.com>
Add a root-level SPEC.md convention for skills and reverse engineer the
canonical skill-writer spec as the reference implementation.
This updates skill-writer so future skill changes separate runtime
instructions from maintenance context: SKILL.md stays focused on
activation and workflow, while SPEC.md captures intent, scope,
source/evidence models, evaluation expectations, known limitations, and
maintenance rules. It also adds focused guidance for reference
architecture, source discovery, and persistent iteration evidence.
The validator now checks SPEC.md structure when present and warns on
long reference files instead of enforcing fixed integration reference
filenames. That keeps coverage requirements while allowing
skill-specific reference names.
Validation: uv run skills/skill-writer/scripts/quick_validate.py
skills/skill-writer --skill-class skill-authoring --strict-depth
Co-authored-by: Codex <codex@openai.com>
Analyzes Sentry session replays to surface UX patterns, pain points,
and user journeys for a given product area. Includes structured
output template, product area URL mapping, and error classification
methodology.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Make repo-root `skills/` and `agents/` the canonical source for the
`sentry-skills` plugin by loading the plugin from repo root instead of
from `plugins/sentry-skills`.
The earlier refactor moved the tree to top level, but leaving a
plugin-local `skills` symlink still created a loader risk for
marketplace installs. This removes that dependency entirely: the
marketplace entry now points at `./`, the root plugin manifest uses
repo-root `skills/` and `agents/`, and the old plugin-local `skills`
path goes away.
This pass also tightens the repo guidance around standard skill
locations. `skill-writer` goes back to using `.agents/skills` as its
default local target, `skill-writer` and `skill-scanner` now explicitly
recognize canonical `skills/<name>/` roots, and the repo docs and
registrations are updated to match the new layout, including
`presentation-creator`.
I validated the change with strict-depth validation for `skill-writer`
and `skill-scanner`, plus a local Claude marketplace add/install smoke
test that produced real `skills/` and `agents/` directories in the
installed plugin cache without any plugin-local `skills` symlink.
---------
Co-authored-by: Codex <noreply@openai.com>
Co-authored-by: Codex <codex@openai.com>
Add a new canonical `prompt-optimizer` skill for creating and refining
agent prompts, system prompts, and reusable prompt templates.
This packages the current prompt guidance we found across OpenAI,
Anthropic, and Gemini into one workflow-oriented skill instead of a
loose collection of tips. The skill covers prompt contracts,
model-family adapters, marker discipline, eval-driven iteration,
and transformed examples.
The later update tightened the skill around prompt compaction and
clarity. It now has an explicit prompt-learnings pass for removing
low-value prompt text, collapsing duplicated instructions, separating
policy from evidence, and ordering long-context inputs deliberately.
The supporting `SOURCES.md` records the local `skill-writer` basis,
provider docs, and prompt-optimization research used to shape the
workflow. The PR also registers the new skill in the public README,
project settings, and the `claude-settings-audit` allowlist.
Move Python to the front of the typing-exclusion-worker description so
trigger matching is clearer for Python repos and the README wording stays in
sync with the skill metadata.
Co-Authored-By: Codex 5.3 <codex@openai.com>
Made-with: Cursor
Add the typing-exclusion-worker skill to the canonical skills tree and register
it so agents can discover and use it consistently across repos with pyproject-
based mypy configuration.
Co-Authored-By: Codex 5.3 <codex@openai.com>
Made-with: Cursor
best used as following for full output
```
claude --agent sentry-skills:senpai
explain relay's role in sentry's infrastructure
```
or like this which delegates to subagent but does an extra step of
unnecessary summarizing
```
ask senpai to explain relay's role in sentry's infrastructure
```
outputs below are single question, agent invokations
Merge skill synthesis into `skill-writer` so there is one canonical flow
for creating and improving skills.
**Canonical workflow consolidation**
`skill-writer` now owns synthesis, authoring, iteration, evaluation, and
registration in one path. This removes split ownership between creation
and synthesis and makes outcomes more consistent.
**`skill-creator` compatibility behavior**
`skill-creator` is now an alias entrypoint rather than a separate
framework. Existing prompts still work, but execution routes to the
canonical `skill-writer` behavior.
**Input-depth and coverage gates**
The workflow now explicitly prioritizes broad source collection before
authoring. It adds coverage/depth gates to reduce shallow skills and
force clearer gap handling.
**Provenance and iteration tracking**
Skill synthesis now records sources and change history in `SOURCES.md`
instead of adding heavy attribution blocks in `SKILL.md`. This improves
traceability and makes iterative updates easier to audit.
**Case-study guidance quality**
Reference examples were upgraded from generic guidance to case-study
style patterns with concrete source-to-decision framing. This is
intended to improve synthesis quality for future skills.
**Cross-agent execution consistency**
Guidance was normalized to be generic across Claude and Codex, with
script execution clarified around `uv run` and skill-directory script
paths. This keeps the workflow portable while staying operationally
concrete.
---------
Co-authored-by: GPT-5 Codex <noreply@openai.com>
* docs: list all available skills
* docs(skills): Align registration guidance and skill allowlists
Require alphabetical ordering when updating the Available Skills table\nin contributor guidance and skill creation workflow docs.\n\nSynchronize skill allowlists with the actual sentry-skills directory so\nautomatic skill injection guidance reflects all available skills.\n\nCo-Authored-By: GPT-5 Codex <noreply@openai.com>
---------
Co-authored-by: shuofengzhang <sofuncheung16@gmail.com>
* ref(skills): Rename PR and skill authoring workflows
Promote pr-writer and skill-writer as canonical skill names while\nkeeping create-pr and skill-creator as compatibility aliases.\n\nUpdate skill registration, settings allowlists, and documentation\nreferences to prefer canonical names.\n\nExtend skill-writer guidance with capability-first naming practices\nand examples for clearer skill discovery.
Co-Authored-By: GPT-5 Codex <noreply@openai.com>
* fix(skills): Address review bot feedback on skill rename
Restrict skill-writer with an explicit allowed-tools frontmatter field,\nremove dead code in quick_validate, and delete orphaned duplicate\nreferences/scripts from the skill-creator alias directory to avoid drift.
Co-Authored-By: GPT-5 Codex <noreply@openai.com>
* fix(skills): Drop allowed-tools from skill-writer
Keep skill-writer frontmatter compatible across clients by avoiding\nthe optional allowed-tools field while retaining the other review\nfixes in this PR.
Co-Authored-By: GPT-5 Codex <noreply@openai.com>
* docs(skill-writer): Default to omitting allowed-tools
Clarify that skill authoring should avoid allowed-tools unless a user\nexplicitly requests strict tool scoping or repo policy requires it,\nsince allowlist syntax differs across clients.
Co-Authored-By: GPT-5 Codex <noreply@openai.com>
* docs(pr-writer): Include update flows in skill discovery text
Expand pr-writer trigger language to explicitly cover updating PR artifacts\nlike title and description, not only creating a new PR.\n\nAlso align the README skill table description so repository docs\nmatch the canonical skill wording.
Co-Authored-By: GPT-5 Codex <noreply@openai.com>
---------
Co-authored-by: GPT-5 Codex <noreply@openai.com>
Add a new skill for reviewing GitHub Actions workflows for security
vulnerabilities, covering expression injection, pwn requests, supply
chain attacks, credential escalation, and AI prompt injection via CI.
Includes reference documentation for all major GHA attack vectors.
Also updates AGENTS.md to the concise agent-instructions format and
registers the new skill in settings and the claude-settings-audit allowlist.
Co-Authored-By: Claude <noreply@anthropic.com>
Replace skill-discovery focus with project-analysis approach. Add line
budget guidance (target 60, max 100), file-scoped commands section,
and anti-patterns for linter duplication. Remove Local Skills required
section since agents discover skills automatically. Rewrite AGENTS.md
for this repo to follow the updated guidance.
Co-authored-by: Claude <noreply@anthropic.com>
Adds a new skill that creates git branches following Sentry naming
conventions. Detects the username from git config, inspects local
changes or prompts for context, classifies the work type, and
proposes a branch name before creating it.
Co-Authored-By: Claude <noreply@anthropic.com>
Add blog-writing-guide to the settings.json allowlist, README skills
table, and claude-settings-audit allowlist so the skill is discoverable
and usable after merge.
Co-Authored-By: Claude <noreply@anthropic.com>
* feat(skill-creator): Synthesize upstream best practices into skill-creator
Research and incorporate patterns from Anthropic's and OpenAI's
skill-creators, the Agent Skills spec, and best practices docs.
Adds planning step, description guidelines, validation script,
Claude Code extension docs, workflow/output patterns, and
expanded anti-patterns.
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: Add skill synthesis guide
Document the agent-driven workflow for researching upstream
implementations and best practices when creating new skills.
Pairs with the skill-creator skill — synthesis handles research,
skill-creator handles implementation.
Co-Authored-By: Claude <noreply@anthropic.com>
---------
Co-authored-by: Claude <noreply@anthropic.com>
* fix(skills): Standardize allowed-tools to comma-separated format
Claude Code docs specify comma-separated format for allowed-tools.
Update all skill frontmatters, documentation, and the scan_skill.py
parser to use and support comma-separated tool lists.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix(skills): Remove model attribute from skill documentation
Skills should not hardcode model overrides — let users control
which model runs their skills.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
* feat(skills): Add skill-creator skill for guided skill authoring
Adds a new skill that walks agents through creating skills for this
repository, covering requirements gathering, writing SKILL.md with
proper frontmatter, creating supporting files, and completing all
registration steps.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* ref(skill-creator): Generalize skill to work in any repository
Remove sentry-skills-specific paths and registration steps. The skill
now teaches general Agent Skills spec conventions and defers to the
target repository's CLAUDE.md for project-specific registration.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Sync the code-simplifier agent as a skill to make it directly usable in
Warden. Adds SKILL.md with frontmatter, examples, and refinement
principles based on Anthropic's official code-simplifier agent.
Simplify installation to two primary methods (Claude Code marketplace
and skills.sh) and consolidate all developer content under Contributing.
Apply Plain Speech guidelines with concise, direct language.
Co-authored-by: Claude <noreply@anthropic.com>
Add a focused security code review skill that evaluates specific files
or changes against OWASP vulnerability patterns.
Features:
- 10 security categories: Injection, XSS, Auth, Authorization, Crypto,
Data Exposure, SSRF, Deserialization, File Operations, Modern Threats
- Reference files with detailed patterns and remediation guidance
- Reports only actual vulnerabilities, not best-practice suggestions
- Focused on single file/change review, not codebase mapping
Reference material derived from OWASP Cheat Sheet Series (CC BY-SA 4.0).
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Explains the three-tier approach for skill placement:
- Global skills in sentry-skills plugin
- Domain-specific skills in dedicated plugins (e.g., infra-skills)
- Repo-specific skills in the repository itself
Also documents how the marketplace structure works - this repo can
host multiple plugins that users install independently.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Explains why we vendor skills (consistency, customization, reliability)
and how to retain attribution via comments and LICENSE files.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add the doc-coauthoring skill from anthropics/skills to help Sentry
employees with structured documentation workflows for proposals,
technical specs, decision docs, and similar content.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add a new skill that helps write copy following Sentry's brand
guidelines. Covers both Plain Speech (default for UI) and Sentry Voice
(personality-rich) tones, with guidance on tone selection, word choices,
dash usage, UI element guidelines, and anti-patterns.
Co-authored-by: Claude <noreply@anthropic.com>
* Replace deslop skill with code-simplifier
- Add new code-simplifier skill with comprehensive simplification guidelines
- Remove old deslop skill directory
- Update README.md to reference code-simplifier instead of deslop
- Update .claude/settings.json with code-simplifier permission
- Update claude-settings-audit skill to include code-simplifier in recommendations
The code-simplifier skill is based on Anthropic's approach and provides more comprehensive code simplification beyond just removing slop, including simplifying complex logic, removing unnecessary abstractions, and improving code readability while maintaining functionality.
Co-authored-by: david <david@sentry.io>
* Convert code-simplifier from skill to subagent
- Create agents/ directory for subagents
- Add code-simplifier.md subagent using Anthropic's official version
- Remove code-simplifier from skills directory
- Update README.md to document subagents separately from skills
- Update .claude/settings.json to remove code-simplifier skill permission (subagents don't require permissions)
- Update claude-settings-audit to not recommend code-simplifier skill
- Update repository structure documentation
The code-simplifier is now a proper subagent following Anthropic's official implementation from claude-plugins-official repo.
Co-authored-by: david <david@sentry.io>
* Add attribution for code-simplifier subagent
- Add source attribution comment to code-simplifier.md pointing to Anthropic's official repo
- Create agents/README.md to document subagents and their sources
- Ensures proper credit and traceability for externally sourced subagents
Co-authored-by: david <david@sentry.io>
* Update attribution to note prior art without license
- Changed attribution from license reference to prior art acknowledgment
- Verified that anthropics/claude-plugins-official has no license file
- Updated both code-simplifier.md and agents/README.md accordingly
- Clarifies we're noting this as prior art from Anthropic rather than claiming any specific license
Co-authored-by: david <david@sentry.io>
* Simplify attribution to just note source
- Remove license commentary from code-simplifier.md
- Remove license mention from agents/README.md
- Keep clean attribution showing it's based on Anthropic's subagent
Co-authored-by: david <david@sentry.io>
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
New skill that guides agents to create and maintain concise AGENTS.md
documentation with CLAUDE.md as a symlink. Enforces minimal style with
headers, bullets, and skill references instead of verbose prose.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Update README installation instructions to reference the new repository
name after renaming from getsentry/sentry-skills to getsentry/skills.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
New skill that guides PR creation following Sentry's engineering practices:
- PR description structure (what, why, alternatives, context)
- Title format following commit conventions
- Issue reference syntax (Fixes/Refs)
- Guidelines on PR scope and reviewer assignment
Notably excludes "Test plan" sections per Sentry conventions.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
New skill that automates the CI feedback loop:
- Checks CI status first, waits for bot checks (sentry/codecov/cursor/bugbot/seer)
- Gathers review feedback from humans and bots
- Investigates failures via gh run view --log-failed
- Validates feedback before acting on it
- Commits fixes and waits for CI to complete
- Repeats until all checks pass
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Clarify repo is primarily for Claude Code but follows open Agent Skills format
- Add instruction to update README when creating new skills
- Remove duplicated skills list from AGENTS.md
- Add missing deslop skill to README
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Simon Hellmayr