Skills · Claude Code · Agent Skills

Ein Shell-Skript ist Produktionscode — ohne Verhandlung.

Mindeststandard für Shell: Strict Mode, shellcheck als Gate, eval verboten, Exit-Code als Vertrag, trap und mktemp. Der Installer passt sich der Umgebung an und gibt nie dem Ausführenden die Schuld.

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

Betreut von Lucas Andrade

schematize-shell · v0.4.0bash
$ schematize install shell
GitHub →Skill (.zip) herunterladen/shell-help · github.com/schematizeme/schematize-cli

Nicht verhandelbare Mindeststandards

Werden nie "um schneller zu sein" abgeschaltet. Die vollständige Liste steht in der Skill.

Strict Mode oder schriftliche Ausnahme

set -euo pipefail in jedem ausführbaren Skript; legitime Ausnahmen gelten nur, wenn sie im Kommentar deklariert sind.

shellcheck ist ein Gate

--severity=warning blockiert den Merge; Unterdrücken verlangt shellcheck disable mit Code und Begründung in der Zeile.

eval ist verboten

Kein eval und kein bash -c mit aus externen Daten gebautem String: Befehle mit einem Array bauen und mit case verteilen.

Exit-Code ist ein Vertrag

0 besteht, 1 fällt durch und 2 heißt, dass nicht geprüft werden konnte; 0 zurückzugeben, ohne etwas geprüft zu haben, ist verboten.

trap und mktemp

trap räumt bei EXIT INT TERM auf, und temporäre Dateien stammen von mktemp, nie von einem vorhersehbaren Namen in /tmp.

Idempotenz und Anführungszeichen

Zweimal ausführen ergibt dasselbe Ergebnis, jede Expansion steht in Anführungszeichen und die Ausgabe von ls wird nie geparst.

Ein Installer, der sich anpasst

Er findet den echten Benutzer unter sudo, den Paketmanager und das Vorhandene; er scheitert mit der Angabe, was jetzt zu tun ist, und Geheimnisse stehen nie in Befehlsargumenten.

Befehle

Installiert in .claude/commands/. Jederzeit /shell-help ausführen.

/shell-ccContext Compact: schreibt das Handoff (Kontext + Checkliste) ins Archive und führt /compact aus.
/shell-claudeErstellt oder ergänzt die dauerhaft aktive CLAUDE.md für schematize-shell im Repo-Root, ohne Blöcke anderer Skills zu überschreiben.
/shell-handoffSchreibt das Kontext-Handoff ins Archive ohne Komprimierung: Sitzungsende oder Aufgabenwechsel.
/shell-helpListet alle Befehle der Skill auf.
/shell-loadLädt den gesamten normativen Teil von schematize-shell zwangsweise und wendet ihn in der Sitzung an.
/shell-reviewPrüft .sh-Dateien (neu oder bestehend) gegen den Standard: führt das Gate aus und liest, was die Maschine nicht liest.

Für KI-Agenten

Installation ohne Mensch im Loop. Metadaten in llms.txt.

  • Ausführen: git clone https://github.com/schematizeme/skill-shell.git && ./skill-shell/install.sh
  • Oder https://github.com/schematizeme/skill-shell/releases/latest/download/skill-shell.zip herunterladen und in .claude/skills/ entpacken.
  • assets/CLAUDE.md ins Repo-Root kopieren (dauerhaft aktive Regel).
  • Mit /shell-help bestätigen.

Nicht installieren wollen?

Lies die vollständigen Standards und kopiere sie direkt in dein Projekt — oder installiere die Skill, damit der Agent sie selbst durchsetzt.