Skills · Claude Code · Agent Skills

Un script shell est du code de production — sans négociation.

Un plancher pour le shell : strict mode, shellcheck comme gate, eval interdit, code de sortie comme contrat, trap et mktemp. L'installeur s'adapte à l'environnement et ne blâme jamais celui qui l'a lancé.

v0.4.0Disciplina · Shellgithub.com/schematizeme/skill-shell

Maintenu par Lucas Andrade

schematize-shell · v0.4.0bash
$ schematize install shell
GitHub →télécharger la skill (.zip)/shell-help · github.com/schematizeme/schematize-cli

Planchers non négociables

Jamais désactivés "pour aller plus vite". La liste complète est dans la skill.

Strict mode ou exception écrite

set -euo pipefail dans tout script exécutable ; les exceptions légitimes ne valent que déclarées en commentaire.

shellcheck est un gate

--severity=warning bloque la fusion ; le faire taire exige shellcheck disable avec code et motif sur la ligne.

eval est interdit

Pas de eval ni de bash -c avec une chaîne construite à partir de données externes : construire la commande avec un tableau et aiguiller avec case.

Le code de sortie est un contrat

0 passe, 1 échoue et 2 signifie qu'on n'a pas pu vérifier ; renvoyer 0 sans rien avoir vérifié est interdit.

trap et mktemp

trap nettoie sur EXIT INT TERM et les temporaires viennent de mktemp, jamais d'un nom prévisible dans /tmp.

Idempotence et guillemets

Lancer deux fois donne le même résultat, toute expansion est entre guillemets et la sortie de ls n'est jamais analysée.

Un installeur qui s'adapte

Il détecte l'utilisateur réel sous sudo, le gestionnaire de paquets et l'existant ; il échoue en disant quoi faire maintenant, et un secret ne passe jamais en argument de commande.

Commandes

Installées dans .claude/commands/. Lancez /shell-help à tout moment.

/shell-ccContext compact : écrit le handoff (contexte + checklist) dans l'archive et lance /compact.
/shell-claudeCrée ou fusionne le CLAUDE.md permanent de schematize-shell à la racine du dépôt, sans écraser les blocs des autres skills.
/shell-handoffÉcrit le handoff de contexte dans l'archive sans compacter : fin de session ou changement de tâche.
/shell-helpListe toutes les commandes de la skill.
/shell-loadCharge de force tout le corpus normatif de schematize-shell et l'applique pendant la session.
/shell-reviewRevoit les .sh (neufs ou existants) face au plancher : lance le gate et lit ce que la machine ne lit pas.

Pour les agents IA

Installez sans humain dans la boucle. Métadonnées dans llms.txt.

  • Lancez : git clone https://github.com/schematizeme/skill-shell.git && ./skill-shell/install.sh
  • Ou téléchargez https://github.com/schematizeme/skill-shell/releases/latest/download/skill-shell.zip et décompressez dans .claude/skills/.
  • Copiez assets/CLAUDE.md à la racine du dépôt (règle permanente).
  • Confirmez avec /shell-help.

Pas envie d'installer ?

Lisez les normes complètes et copiez-les directement dans votre projet — ou installez la skill pour que l'agent les applique tout seul.