Skills · Claude Code · Agent Skills

Una skill è un pacchetto software: versione, gate e release — senza negoziare.

Crea e mantiene le skill del catalogo con anatomia completa, description snella, stessa versione in 4 posti, script testati con caso rosso e release solo con gate verde.

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

Gestito da Lucas Andrade

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

Basi non negoziabili

Non si spengono "per andare più veloce". Elenco completo nella skill.

Un repo per skill

Cartella skill-[slug], name schematize-[slug], repo pubblico dedicato e prefisso dei comandi unico nel catalogo.

Anatomia completa

SKILL.md, skill.toml, VERSION, CHANGELOG, README, LICENSE, install.sh, assets, references, scripts e snapshot in versions/; nessuno zip nel pacchetto.

Description breve con confine

Blocco >- di al massimo 350 caratteri: cos’è, un innesco d’uso concreto e il confine con la skill vicina, senza rivendicare territorio altrui.

Stessa versione in 4 posti

VERSION, skill.toml, frontmatter e riga Versione di SKILL.md coincidono, il CHANGELOG spiega il perché e skills.json segue.

Blocco ereditato mai a mano

La fonte è schematize-engineering; si cambia lì e si esegue il sync, mai il blocco ereditato direttamente nella skill.

Ogni script con test rosso e verde

Il caso rosso è stato visto fallire prima di passare: un gate che non sa bocciare è decorazione.

Release solo con gate verde

Albero pulito, main sincronizzata, git add con elenco esplicito, tag annotato, zip con top-level schematize-[slug]/, poi grafo e skills.json rigenerati.

Comandi

Installati in .claude/commands/. Usa /skill-help quando vuoi.

/skill-bumpAlza la versione nei 4 posti, scrive lo snapshot e pretende la voce del CHANGELOG.
/skill-ccContext compact: scrive contesto + checklist nell'archivio ed esegue /compact.
/skill-claudeCrea o unisce il CLAUDE.md sempre attivo di skill-dev nella radice (non sovrascrive blocchi di altre skill).
/skill-handoffScrive l'handoff di contesto senza compattare — fine sessione o cambio attività.
/skill-helpElenca tutti i comandi.
/skill-loadCarica a forza l’intero corpo normativo: anatomia, description, ereditati, lint e test, release e catalogo.
/skill-newFa lo scaffold completo di una skill nuova, che supera già il gate.
/skill-releaseIl rito di release: gate, bump, snapshot, zip, tag, GitHub Release, grafo e skills.json.
/skill-reviewVerifica una skill contro la base: gate, lint del catalogo e lettura di ciò che la macchina non legge.

Per agenti IA

Installa senza intervento umano. Metadati in llms.txt.

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