Vai al contenuto
Pathrule

skill

Dai un nome al lavoro.
Non ai passaggi.

Skill riutilizzabili per agenti di programmazione IA: procedure con un nome che l'agente invoca invece di ricostruire i passaggi, così il quarto passaggio smette di andare perso.

Claude Codeesempio
Riproduci in locale il pagamento fallito di ieri.

Senza

Ho trovato l'evento, avviato il server e inviato il payload al webhook.

Webhook rifiutato: controllo della firma fallito.3 passaggi su 5

Con la skill

skill replay-stripe-webhook

  • Recuperato l'evento tramite id
  • Caricato il signing secret locale
  • Avviato il server con i webhook attivi
  • Rieseguito con una nuova idempotency key
  • Controllato il log dell'handler

L'handler ha restituito 200.5 passaggi su 5

Stessi passaggi. Ogni settimana.

  1. Settimana 1tu, a claude code

    "Incrementa la versione, compila entrambi i brand, carica, poi crea il tag."

  2. Settimana 2tu, a codex

    "Prima la versione. Poi entrambi i brand, non uno solo."

  3. Settimana 3tu, a claude code

    "Hai creato il tag prima di caricare. Di nuovo."

  4. Settimana 4tu, a qualsiasi agente

    ::release-mobile

3 spiegazioni1 skill0 passaggi saltati da allora

Il segnale non è la complessità, ma il fatto che ti ripeti. Oltre i tre passaggi, o con un ordine obbligato, dovrebbe essere una skill. Al di sotto, basta una memoria.

È la descrizione a fare il lavoro.

SKILL.md
---name: replay-stripe-webhookdescription: Riproduci un evento di pagamento di produzione sul server locale.---# Riproduci un webhook Stripe1. Recupera l'evento tramite id2. Carica il signing secret locale3. Riesegui con una nuova idempotency key
prompt"Riproduci il pagamento fallito di ieri"
  • "Helper per Stripe"stripe-helpersscartata
  • "Riproduci un evento di pagamento di produzione sul server locale"replay-stripe-webhookinvocata

Una skill che l'agente non invoca mai di solito ha un problema di descrizione. Indica il trigger, non l'argomento, altrimenti vince il piano dell'agente.

Una skill. Ogni percorso che ne ha bisogno.

replay-stripe-webhook

Scritta una volta, a livello di workspace. Collegata ovunque si svolga il lavoro, mai copiata.

  • /services/billingcollegata
  • /services/webhookscollegata
  • /apps/admin/paymentscollegata
  • /apps/mobilenon qui
raggiunge
  • Claude Code.claude/skills
  • Codex.agents/skills
  • Cursor, Copilot, Windsurftramite MCP
manual
Scritta in Pathrule
template
Un modello di partenza, copiato
github_ref
Recuperata, poi messa in cache

Il collega che arriva il mese prossimo riceve la skill senza che nessuno debba dirgli che esiste. Le skill obsolete o in conflitto emergono come suggerimenti, e una persona approva la correzione.

Domande frequenti.

Che cos'è una skill per agenti IA?

Una procedura riutilizzabile e con un nome che un agente IA di programmazione può richiamare invece di ricostruire i passaggi: rieseguire in locale un webhook di Stripe, rigenerare le fixture di seed, eseguire la checklist pre-rilascio. Il corpo è un piccolo file Markdown il cui frontmatter dà un nome alla skill e descrive a cosa serve.

Quando conviene scrivere una skill invece di una memoria?

Quando si tratta di una sequenza e l'ordine conta. Ricorri a una skill oltre i tre passaggi, o ogni volta che una parte richiede di "fare le cose in quest'ordine". Una o due righe, o un fatto che all'agente basta conoscere invece di eseguire, sono una memoria.

Perché il mio agente non usa la skill che ho scritto?

Molto spesso la descrizione non dice a cosa serve la skill. Le skill vengono selezionate in base alla descrizione, quindi una descrizione vaga perde contro il piano predefinito dell'agente: indica quando usarla, non l'argomento. Le altre cause comuni sono un ambito che non corrisponde mai ai percorsi in cui si svolge il lavoro e una procedura che contiene ancora una vera decisione a metà strada. Approfondimento: perché le skill di Claude Code non si attivano.

Una skill si può condividere con tutto il team?

Sì, ed è proprio questo il senso di conservarla fuori da un prompt. Le skill sono a livello di workspace e vengono associate ai nodi tramite una join, così una stessa skill si riutilizza su molti percorsi e l'agente di ogni collega può richiamarla. L'appartenenza all'organizzazione e l'accesso al workspace sono controllati lato server. Vedi ruoli e permessi.

Posso usare skill pubblicate da altri?

Sì. Una skill può avere come fonte un URL GitHub esterno, e Pathrule ne scarica il corpo e lo mette in cache. La copia in cache è l'ultima istantanea servita, e il workspace recepisce le modifiche a monte al prossimo aggiornamento. Usa questa opzione per le skill pubblicate da un ecosistema di cui ti fidi.

Che differenza c'è tra una skill e un Pathrule Pattern?

Una skill è una singola procedura. Un Pattern è un piccolo pacchetto di memorie, regole e skill su un argomento, con ogni pezzo già legato al percorso a cui appartiene, perché una convenzione reale raramente sta in un solo file. Approfondimento: cos'è un Pathrule Pattern, e perché non è una skill.

Le skill sostituiscono i miei prompt?

No, ne eliminano la ripetizione. Vale la pena scrivere una skill quando ti accorgi di rispiegare la stessa procedura. A quel punto il prompt nomina il lavoro invece di descriverlo, e i passaggi smettono di cambiare da una spiegazione all'altra.

Scrivi i passaggi una volta.
Poi dai un nome al lavoro.