Skills · Claude Code · Agent Skills

Uma skill é um pacote de software: versão, gate e release — sem negociação.

Cria e mantém skills do catálogo com anatomia completa, description enxuta, versão igual nos 4 lugares, scripts testados com caso vermelho e release só com gate verde.

v0.2.0Disciplina · Autoria de skillsgithub.com/schematizeme/skill-skill-dev

Mantido por Lucas Andrade

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

Pisos inegociáveis

Não se desligam "pra ir mais rápido". Lista completa na skill.

Um repo por skill

Diretório skill-[slug], name schematize-[slug], repo público próprio e prefixo de comandos único no catálogo.

Anatomia completa

SKILL.md, skill.toml, VERSION, CHANGELOG, README, LICENSE, install.sh, assets, references, scripts e snapshot em versions/; nenhum zip dentro do pacote.

Description curta e com divisa

Bloco >- de no máximo 350 caracteres: o que é, gatilho concreto de uso e a divisa com a skill vizinha, sem reivindicar território alheio.

Versão igual nos 4 lugares

VERSION, skill.toml, frontmatter e linha Versão do SKILL.md batem, o CHANGELOG explica o porquê e o skills.json acompanha.

Bloco herdado nunca à mão

A fonte é a schematize-engineering; muda lá e roda o sync, nunca edite o bloco herdado direto na skill.

Todo script com teste vermelho e verde

O caso vermelho foi visto falhar antes de passar: gate que não sabe reprovar é decoração.

Release só com gate verde

Árvore limpa, main sincronizada, git add com lista explícita, tag anotada, zip com top-level schematize-[slug]/ e depois grafo e skills.json regenerados.

Comandos

Instalados em .claude/commands/. Use /skill-help a qualquer momento.

/skill-bumpSobe a versão nos 4 lugares, grava o snapshot e cobra a entrada do CHANGELOG.
/skill-ccContext compact: gera contexto + checklist no archive e roda /compact.
/skill-claudeCria ou mescla o CLAUDE.md sempre-on de skill-dev na raiz (não sobrescreve blocos de outras skills).
/skill-handoffGera o handoff de contexto sem compactar — fim de sessão ou troca de tarefa.
/skill-helpLista todos os comandos.
/skill-loadCarrega à força o corpo normativo: anatomia, description, herdados, lint e testes, release e catálogo.
/skill-newFaz o scaffold completo de uma skill nova, já passando no gate.
/skill-releaseO rito de release: gate, bump, snapshot, zip, tag, GitHub Release, grafo e skills.json.
/skill-reviewAudita uma skill contra o piso: gate, lint do catálogo e leitura do que a máquina não lê.

Para agentes de IA

Instale sem intervenção humana. Metadados em llms.txt.

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

Não quer instalar?

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