Compétences linux-troubleshooting
🖥️

linux-troubleshooting

Sûr ⚙️ Commandes externes

Diagnostic et résolution des problèmes système Linux

Les administrateurs Linux sont confrontés à des pannes système complexes nécessitant un diagnostic structuré. Ce workflow offre une approche en sept phases pour identifier systématiquement les causes racines et implémenter des corrections vérifiées.

Prend en charge: Claude Codex Code(CC)
📊 70 Adéquat
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "linux-troubleshooting". Le serveur fonctionne lentement. Commencez le dépannage.

Résultat attendu:

  • Phase 1 - Évaluation initiale terminée :
  • - Temps de disponibilité système : 45 jours
  • - OS : Ubuntu 22.04 LTS
  • - Mise à jour récente du noyau détectée dans dmesg
  • Phase 2 - Analyse des ressources :
  • - CPU : 95% d'utilisation par le processus java (PID 4521)
  • - Mémoire : 7,8 Go/8 Go utilisés, forte activité de swap
  • - Disque : /var à 92% de capacité
  • Action recommandée : Enquêter sur la fuite de mémoire du processus Java et libérer de l'espace disque dans /var/log

Utilisation de "linux-troubleshooting". Le service nginx n'a pas démarré après modification de la configuration

Résultat attendu:

  • Résultats de la Phase 6 - Dépannage des services :
  • - systemctl status nginx : Échec avec code de sortie 1
  • - journalctl -u nginx : 'nginx: [emerg] unknown directive' à la ligne 47
  • - Test de configuration : nginx -t montre une erreur de syntaxe dans /etc/nginx/sites-enabled/default
  • Cause racine : Directive invalide introduite dans la modification récente de la configuration
  • Correction : Restaurer la configuration précédente à partir de la sauvegarde et recharger nginx

Audit de sécurité

Sûr
v1 • 2/25/2026

All 47 static analysis findings are false positives. The SKILL.md file is documentation-only (markdown) containing workflow instructions and example commands. The detected 'backtick execution' patterns are markdown code fence markers (```bash), not Ruby/shell backticks. The 'hardcoded URL' and 'reconnaissance' patterns are documented examples for users, not executable code. No actual security risks detected.

1
Fichiers analysés
222
Lignes analysées
2
résultats
1
Total des audits
Problèmes à risque faible (1)
Documentation Contains Shell Command Examples
The skill documentation includes example shell commands for system diagnostics (uptime, top, df, journalctl, etc.). These are intended for user execution via other skills, not direct code execution by this skill.
Audité par: claude

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
32
Communauté
100
Sécurité
83
Conformité aux spécifications

Ce que vous pouvez construire

Réponse aux pannes de serveur de production

Suivez le workflow en sept phases pour diagnostiquer pourquoi un serveur de production est devenu sans réponse, identifier la cause racine (épuisement des ressources, défaillance de service ou problème réseau) et implémenter une correction vérifiée.

Investigation de la dégradation des performances

Utilisez les phases d'analyse des ressources et d'investigation des processus pour identifier quels processus consomment un excès de CPU ou de mémoire, puis travaillez avec la compétence server-management pour résoudre le problème.

Diagnostic des défaillances de service

Appliquez la phase de dépannage des services pour diagnostiquer pourquoi les services systemd échouent à démarrer, examinez les journaux avec la compétence error-detective et implémentez les corrections de configuration.

Essayez ces prompts

Vérification de base de l'état du système
Utilisez le workflow linux-troubleshooting pour vérifier l'état du système. Commencez par la Phase 1 (Évaluation initiale) et la Phase 2 (Analyse des ressources). Exécutez uptime, vérifiez l'utilisation du CPU et de la mémoire avec top et free, et rapportez l'espace disque avec df -h.
Service ne démarre pas
Un service critique échoue à démarrer. Suivez la Phase 6 (Dépannage des services) pour vérifier systemctl status, examinez les journaux avec journalctl -u service -f, et identifiez les problèmes de configuration. Utilisez ensuite la Phase 4 (Analyse des journaux) pour rechercher les erreurs connexes dans /var/log/.
Problèmes de connectivité réseau
Les utilisateurs ne peuvent pas atteindre notre serveur web. Exécutez la Phase 5 (Diagnostics réseau) pour vérifier les interfaces réseau avec ip addr, vérifier les ports d'écoute avec ss -tulpn, tester la connectivité avec curl, et vérifier la résolution DNS avec dig. Corrélez les résultats avec les règles du pare-feu.
Réponse complète aux incidents
Le serveur de production rencontre des problèmes critiques. Exécutez le workflow linux-troubleshooting complet en sept phases : (1) Évaluation initiale, (2) Analyse des ressources, (3) Investigation des processus, (4) Analyse des journaux, (5) Diagnostics réseau, (6) Dépannage des services, (7) Résolution. Documentez les résultats à chaque phase et implémentez des corrections vérifiées.

Bonnes pratiques

  • Documentez toujours les résultats à chaque phase avant de passer à la suivante
  • Vérifiez les corrections en réexécutant les commandes de diagnostic pour confirmer la résolution
  • Créez des plans de prévention après la résolution pour éviter les problèmes récurrents

Éviter

  • Passer des phases et sauter directement aux redémarrages sans diagnostiquer la cause racine
  • Implémenter des corrections sans d'abord vérifier la cause racine identifiée
  • Ne pas surveiller la stabilité du système après avoir appliqué la résolution

Foire aux questions

Quelles compétences dois-je utiliser pour ce workflow ?
Ce workflow coordonne bash-linux pour l'exécution des commandes, performance-engineer pour l'analyse des ressources, server-management pour la gestion des processus et services, error-detective pour l'analyse des journaux, et network-engineer pour les diagnostics réseau. Chaque phase spécifie les compétences à invoquer.
Ce workflow peut-il corriger automatiquement les problèmes ?
Non, c'est un guide de workflow structuré. Il fournit des étapes de diagnostic systématique et coordonne d'autres compétences pour exécuter les commandes. Toutes les corrections nécessitent l'approbation de l'utilisateur avant la mise en œuvre.
Que se passe-t-il si je dois vérifier une seule zone spécifique ?
Vous pouvez exécuter des phases individuelles indépendamment. Par exemple, exécutez uniquement la Phase 5 pour les problèmes réseau ou la Phase 4 pour l'analyse des journaux. Le workflow est modulaire et chaque phase est autonome.
Comment documenter le processus de dépannage ?
La Phase 1 comprend la collecte des résultats initiaux, et la Phase 7 comprend la création de la documentation de résolution. Chaque phase a une étape 'Documenter les résultats'. Le workflow encourage la maintenance d'un journal de dépannage tout au long du processus.
Quelles permissions dois-je avoir pour exécuter ces diagnostics ?
La plupart des commandes de diagnostic (top, df, ss) fonctionnent avec les permissions utilisateur standard. Certaines commandes comme journalctl -xe, strace et la gestion des services nécessitent un accès sudo/root. Assurez-vous que votre session Claude Code dispose des permissions système appropriées.
Puis-je utiliser ce workflow pour les environnements conteneurisés ?
Oui, mais certaines commandes peuvent se comporter différemment dans les conteneurs. Les commandes comme systemctl peuvent ne pas fonctionner dans les conteneurs sans systemd. Adaptez le workflow en utilisant des alternatives spécifiques aux conteneurs (docker top, docker logs) le cas échéant.

Détails du développeur

Structure de fichiers

📄 SKILL.md