Skills · Claude Code · Agent Skills

Script de shell é código de produção — sem negociação.

Piso para shell: strict mode, shellcheck como gate, eval vetado, exit code como contrato, trap e mktemp. O instalador se adapta ao ambiente e nunca culpa quem o rodou.

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

Mantido por Lucas Andrade

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

Pisos inegociáveis

Nunca desligados "para ir mais rápido". A lista completa está na skill.

Strict mode ou exceção escrita

set -euo pipefail em todo script executável; as exceções legítimas valem declaradas em comentário.

shellcheck é gate

--severity=warning trava o merge; silenciar exige shellcheck disable com código e motivo na linha.

eval é vetado

Nada de eval nem bash -c com string montada de dado externo: use array para montar o comando e case para despachar.

Exit code é contrato

0 passa, 1 reprova e 2 significa que não deu para verificar; devolver 0 sem ter checado nada é proibido.

trap e mktemp

trap limpa em EXIT INT TERM e temporários nascem de mktemp, nunca de nome previsível em /tmp.

Idempotência e aspas

Rodar duas vezes dá o mesmo resultado, toda expansão vai entre aspas e a saída de ls nunca é parseada.

Instalador que se adapta

Descobre o usuário real sob sudo, o gerenciador de pacotes e o que já existe; falha dizendo o que fazer agora, e segredo nunca vai em argumento de comando.

Comandos

Instalados em .claude/commands/. Rode /shell-help quando quiser.

/shell-ccContext compact: grava o handoff (contexto + checklist) no archive e roda /compact.
/shell-claudeCria ou mescla o CLAUDE.md sempre-on de schematize-shell na raiz do repo, sem sobrescrever blocos de outras skills.
/shell-handoffGera o handoff de contexto no archive, sem compactar: fim de sessão ou troca de tarefa.
/shell-helpLista todos os comandos da skill.
/shell-loadCarrega à força todo o corpo normativo de schematize-shell e passa a aplicá-lo na sessão.
/shell-reviewRevisa .sh (novo ou existente) contra o piso: roda o gate e lê o que a máquina não lê.

Para agentes de IA

Instale sem humano no loop. Metadados em llms.txt.

  • Execute: git clone https://github.com/schematizeme/skill-shell.git && ./skill-shell/install.sh
  • Ou baixe https://github.com/schematizeme/skill-shell/releases/latest/download/skill-shell.zip e descompacte em .claude/skills/.
  • Copie assets/CLAUDE.md para a raiz do repo (regra sempre ativa).
  • Confirme com /shell-help.

Não quer instalar?

Leia as normativas completas e copie direto pro seu projeto — ou instale a skill para o agente aplicar sozinho.