Skills · Claude Code · Agent Skills

Uno script shell è codice di produzione — senza negoziazione.

Uno standard per la shell: strict mode, shellcheck come gate, eval vietato, exit code come contratto, trap e mktemp. L'installer si adatta all'ambiente e non dà mai la colpa a chi lo ha eseguito.

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

Gestito da Lucas Andrade

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

Standard minimi non negoziabili

Mai disattivati "per andare più veloci". L'elenco completo è nella skill.

Strict mode o eccezione scritta

set -euo pipefail in ogni script eseguibile; le eccezioni legittime valgono solo dichiarate in un commento.

shellcheck è un gate

--severity=warning blocca il merge; silenziarlo richiede shellcheck disable con codice e motivo sulla riga.

eval è vietato

Niente eval né bash -c con stringhe costruite da dati esterni: costruire il comando con un array e smistare con case.

L'exit code è un contratto

0 passa, 1 fallisce e 2 significa che non è stato possibile verificare; restituire 0 senza aver controllato nulla è vietato.

trap e mktemp

trap pulisce su EXIT INT TERM e i temporanei nascono da mktemp, mai da un nome prevedibile in /tmp.

Idempotenza e virgolette

Eseguire due volte dà lo stesso risultato, ogni espansione è tra virgolette e l'output di ls non viene mai analizzato.

Un installer che si adatta

Scopre l'utente reale sotto sudo, il gestore di pacchetti e ciò che esiste già; fallisce dicendo cosa fare adesso, e i segreti non vanno mai negli argomenti di comando.

Comandi

Installati in .claude/commands/. Esegui /shell-help quando vuoi.

/shell-ccContext compact: scrive l'handoff (contesto + checklist) nell'archive ed esegue /compact.
/shell-claudeCrea o unisce il CLAUDE.md sempre attivo di schematize-shell nella radice del repo, senza sovrascrivere i blocchi di altre skill.
/shell-handoffScrive l'handoff di contesto nell'archive senza compattare: fine sessione o cambio attività.
/shell-helpElenca tutti i comandi della skill.
/shell-loadCarica forzatamente l'intero corpo normativo di schematize-shell e lo applica nella sessione.
/shell-reviewRivede i .sh (nuovi o esistenti) rispetto allo standard: esegue il gate e legge ciò che la macchina non legge.

Per gli agenti IA

Installa senza umano nel ciclo. Metadati in llms.txt.

  • Esegui: git clone https://github.com/schematizeme/skill-shell.git && ./skill-shell/install.sh
  • Oppure scarica https://github.com/schematizeme/skill-shell/releases/latest/download/skill-shell.zip e decomprimi in .claude/skills/.
  • Copia assets/CLAUDE.md nella radice del repo (regola sempre attiva).
  • Conferma con /shell-help.

Non vuoi installare?

Leggi le norme complete e copiale direttamente nel tuo progetto — oppure installa la skill perché l'agente le applichi da solo.