Skill

Una skill è una breve guida per un tipo di lavoro: una cartella con un SKILL.md (un nome, una descrizione che dice quando usarla, e le istruzioni), il formato aperto che leggono Claude Code, Codex e OpenCode. Kedalio tiene le tue skill sul server, così ogni run su ogni host riceve le stesse.

La libreria

Sistema → Skill elenca la tua libreria. Ogni skill ha:

• un ambito: account (tutto Kedalio) o project:<nome> (un solo progetto);
• uno stato: in prova, attiva o scaduta.

Ogni scrittura di una skill è una revisione, conservata come storia.

Prove, ambiti e promozione

Una squadra che trova un modo che vale la pena tenere può scrivere una skill, ma solo di prova, e solo per il proprio progetto (skills.edit). Una prova viene data ai run di quel progetto e scade dopo 30 giorni senza uso (resta come storia).

Promuovi solo tu. Nella libreria, Promuovi rende attiva dov’è una prova (o una scaduta); su una skill attiva di un progetto la porta su a tutto il tuo account, e la skill dell’account mostra da dove viene. La copia del progetto resta come revisione. Puoi anche scrivere, modificare e controllare le skill da Claude o ChatGPT con il connettore (skills.edit per qualunque ambito e stato, skills.check per validare una bozza sul formato).

L’app promuove e legge; non modifica il testo di una skill. Di default non è installato niente.

Cosa riceve un run

Un run riceve le skill attive del tuo account e del suo progetto, più le prove di quel progetto; su un nome che hanno entrambi vince l’ambito più stretto. Il tetto è 40 skill e 2 MB. Le skill di un progetto costano a ogni run i token delle loro descrizioni, quindi tieni le descrizioni brevi ed esatte.

Un capo può avviare un figlio con skills: [] per tenerlo stretto; il router e il verificatore della cascata ricevono solo le skill della loro ricetta.

Ricette

Una ricetta è una skill che nomina le sue compagne (metadata.kedalio.recipe nel suo front matter): work.start con una recipe avvia le skill insieme. Poiché è una skill, tu e le tue squadre potete scrivere ricette come scrivete skill.

Retrospettive

Dopo una squadra andata male, Kedalio legge cos’è successo e propone modifiche. Una retrospettiva si fa quando una squadra:

• è fallita dopo essere partita;
• è andata oltre il budget (costo o scadenza);
• ha avuto una richiesta negata da te;
• ha avuto il brief modificato da te;
• ha avuto un verificatore che ha risposto failed;
• oppure ha scritto una skill di prova.

Puoi chiederne una anche su qualunque squadra, una volta (skills.retro). È un breve run di solo testo di un modello piccolo (Haiku, con un login di Claude Code), quindi costa poco, e risponde con al massimo tre modifiche. Ogni modifica dice il bersaglio (una delle skill che il run aveva, o le regole del progetto), il passaggio esatto che sostituisce, il testo nuovo e perché. Cambia un passaggio, non un testo intero, così leggi una differenza.

Una proposta ti arriva come notifica, in Oggi → Da decidere, in Sistema → Il mio agente → Modifiche proposte, e in Sistema → Skill → Da approvare. Nella sua pagina approvi, modifichi prima il testo nuovo, o scarti. Approvare la applica come revisione a cui puoi tornare; se il passaggio non c’è più, la proposta è segnata superata e non fa nulla. Le regole dell’agente imparano dai tuoi brief modificati a parte (Il tuo agente).

Valutare una skill

skills.eval esegue i casi di una skill (un evals.json accanto: un brief su un repository di prova, con controlli oggettivi) con e senza la skill, come run veri sul modello che scegli, poi giudicati; il risultato e il suo costo restano con la skill. Tocca a te lanciarla, dal connettore.

Le skill che Kedalio include

Sette skill fanno parte del prodotto, in sola lettura, e si raggiungono per nome quando la tua libreria non ne ha una con quel nome, quindi funzionano prima di installare qualunque cosa:

Skill	A cosa serve
cascade	La ricetta: un router sceglie il modello, quello lavora, un verificatore controlla, un fallimento sale di un gradino (Motori e costi).
cascade-router	Il primo passo della cascata: un’etichetta (haiku, sonnet, opus, fable) e una riga del perché.
cascade-verifier	Controlla il lavoro su criteri oggettivi e risponde ok, doubtful o failed.
model-card	In cosa è bravo ogni modello, quanto costa e come istruirlo.
agent-routing	Quale modello prende quale ruolo quando avvii altri agenti.
account-pacing	Quale account dei motori prende il prossimo lavoro, in base al ritmo.
kedalio-product	Dove si fanno le cose nell’app e cosa può e non può fare da solo il tuo agente; ogni run del tuo agente la riceve, installata o no.

Non ancora costruito: un catalogo di skill da fonti esterne da installare con un tocco; le sette sopra sono tutto ciò che Kedalio include.