Synthèse automatique
Passe en revue une configuration Sentry existante pour repérer les pièges courants du SDK et appliquer les correctifs correspondants.
Points forts
- Liste de contrôle précise couvrant l'initialisation du SDK, la capture d'objets Error, beforeSend, le DSN et les sample rates
- Inclut des points souvent oubliés comme le finish() des transactions en try/finally et la correspondance du préfixe des source maps
- Produit un résultat concret : pièges identifiés, correctifs appliqués et configuration validée
- Couvre aussi la configuration des alertes pour limiter la fatigue d'alerte
Limites
- Suppose qu'une implémentation Sentry existe déjà et qu'il faut un accès au code et à la configuration du SDK
- Ne détaille pas les vérifications : renvoie vers des fichiers de références externes (errors.md, examples.md) non fournis ici
- Reste centré sur les pièges génériques du SDK, sans analyse spécifique à un framework ou à un langage particulier
À utiliser lors d'un audit ou d'un dépannage d'une intégration Sentry existante, ou avant une mise en production pour éviter les erreurs de configuration classiques.
À éviter si vous cherchez à instrumenter Sentry pour la première fois ou à écrire du code de tracing applicatif plutôt qu'à auditer une configuration.
Analyse de sécurité
SûrThe skill only uses Read, Write, Edit, and Grep tools for reviewing and fixing Sentry configuration issues. It does not execute shell commands, make network requests, or perform destructive or exfiltrating actions. The instructions are limited to code inspection and benign edits.
Aucun point d'attention détecté
Comment cette analyse est faiteExemples
Review our Sentry SDK configuration and list every common pitfall we are hitting, then apply the fixes.Our Sentry dashboard is missing errors even though they show up in logs — check our setup against known Sentry pitfalls.Run a Sentry best-practices review before we ship: sample rates, init order, source maps and alert thresholds.name: sentry-known-pitfalls description: | Execute common Sentry pitfalls and how to avoid them. Use when troubleshooting Sentry issues, reviewing configurations, or preventing common mistakes. Trigger with phrases like "sentry mistakes", "sentry pitfalls", "sentry common issues", "sentry anti-patterns". allowed-tools: Read, Write, Edit, Grep version: 1.0.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io
Sentry Known Pitfalls
Prerequisites
- Existing Sentry implementation to review
- Access to SDK configuration
- Understanding of current error patterns
- Codebase access for fixes
Instructions
- Verify SDK initialization happens before app starts
- Check for single initialization point (no multiple init calls)
- Use framework-specific SDK package for your framework
- Ensure Error objects are captured (not strings)
- Verify beforeSend returns event or null explicitly
- Check DSN is in environment variables (not hardcoded)
- Review sample rates for production appropriateness
- Verify all transactions call finish() in try/finally
- Check source map URL prefix matches actual URLs
- Review alert configuration for threshold-based rules (avoid alert fatigue)
Output
- Pitfalls identified in current setup
- Fixes applied for each issue
- Configuration validated
- Best practices checklist completed
Error Handling
See {baseDir}/references/errors.md for comprehensive error handling.
Examples
See {baseDir}/references/examples.md for detailed examples.
Resources
Du fichier au premier essai
Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.
Consulter la source et ses fichiers annexesCe téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.
1. Télécharger le fichier
Télécharger SKILL.mdDepuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/sentry-known-pitfalls-mtnxbs30/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.
Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.
mkdir -p '.skill-downloads/sentry-known-pitfalls-mtnxbs30' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/sentry-known-pitfalls-mtnxbs30/download' --output '.skill-downloads/sentry-known-pitfalls-mtnxbs30/SKILL.md.part' && mv '.skill-downloads/sentry-known-pitfalls-mtnxbs30/SKILL.md.part' '.skill-downloads/sentry-known-pitfalls-mtnxbs30/SKILL.md'2. Vérifier les prérequis
Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.
Outils déclarés par l’auteur (à vérifier dans votre agent) : Read, Write, Edit, Grep
Extrait original : Prerequisites
- Existing Sentry implementation to review
- Access to SDK configuration
- Understanding of current error patterns
- Codebase access for fixes
Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.
3. Charger la skill
Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.
Claude Code
test -f '.skill-downloads/sentry-known-pitfalls-mtnxbs30/SKILL.md' && test -s '.skill-downloads/sentry-known-pitfalls-mtnxbs30/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/sentry-known-pitfalls' && cp -R '.skill-downloads/sentry-known-pitfalls-mtnxbs30' '.claude/skills/sentry-known-pitfalls'Cursor
test -f '.skill-downloads/sentry-known-pitfalls-mtnxbs30/SKILL.md' && test -s '.skill-downloads/sentry-known-pitfalls-mtnxbs30/SKILL.md' && mkdir -p '.cursor/skills' && test ! -e '.cursor/skills/sentry-known-pitfalls' && cp -R '.skill-downloads/sentry-known-pitfalls-mtnxbs30' '.cursor/skills/sentry-known-pitfalls'OpenSkills
OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.
Installation officielle d’OpenSkillsopenskills install './.skill-downloads/sentry-known-pitfalls-mtnxbs30'openskills read 'sentry-known-pitfalls-mtnxbs30'La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.
Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.
openskills syncMode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.
4. Faire un premier essai
Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :
Lis .skill-downloads/sentry-known-pitfalls-mtnxbs30/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.
Configurer un canal de discussion avec SecretRefs
DevOps
Configurez des canaux de discussion avec des commandes non interactives, les secrets étant uniquement des SecretRefs. Couvre les étapes de collecte, modification, réparation et vérification.
Enquêter sur les échecs CI de ClickHouse
DevOps
Investigue un échec CI de ClickHouse de bout en bout à partir d'une URL de PR ou de rapport S3. Récupère les tests échoués, classe flaky vs vraie régression, et cherche des issues/fixes existants.
Revue de PR Ansible
DevOps
Examine une PR Ansible selon le processus standardisé du projet, incluant la validation des changelogs, la couverture de tests et le suivi des commentaires.