Skill

Una skill è un processo ripetibile e graduale progettato per completare un'attività specifica senza il consueto scambio di messaggi.

Letaido lo legge su richiesta quando il task corrisponde alla descrizione della skill, quindi segue le istruzioni che contiene.

Fai clic su Anteprima per vedere le istruzioni effettive, quali input sono richiesti da parte tua e un esempio dell'output di esempio.

Skill predefinite (curate da Ahrefs)

Letaido include una libreria di skill in continua crescita, mantenuta e aggiornata regolarmente dal team di Ahrefs. Grazie a queste, Letaido opera come un marketer di livello mondiale fin da subito.

Skill dell'area di lavoro (le tue skill)

Un secondo livello di skill si trova nella tua area di lavoro sotto ~/workspace/skills/<skill-name>/SKILL.md. Queste sono le regole specifiche per il tuo team, prodotto, tono di voce e flussi di lavoro. Le scrivi, modifichi e curi tu.

Puoi anche chiedere nella chat di avere il file completo della skill inline per le modifiche.

Come aggiungere una nuova skill

La forma della richiesta:

"Crea una skill chiamata <name> che catturi <rules>. La descrizione del trigger dovrebbe essere <one-line>. Esempi di riferimento: <paste or attach>."

Letaido:

1. Redige il SKILL.md con le regole, strutturato per un facile recupero.
2. Lo inserisce in ~/workspace/skills/<name>/.
3. Lo testa ponendosi una domanda rappresentativa e leggendo la skill durante l'esecuzione.

Come aggiornare una skill

Modifica diretta del file, oppure "aggiorna la skill della voce del brand: aggiungi la regola che non usiamo mai i trattini lunghi". L'agente aggiunge o rivede sul posto. La chat successiva rileva automaticamente la modifica.

Come è strutturata una skill

~/workspace/skills/<skill-name>/
  SKILL.md            ← required; description in frontmatter, body is the playbook
  reference.md        ← optional supporting docs
  examples/...        ← optional examples
  assets/...          ← optional images, templates, CSS

Il frontmatter di SKILL.md ha questo aspetto:

---
name: ahrefs-brand-voice
description: Voice rules and review checklist for any Ahrefs copy. Load when writing or reviewing copy for landing pages, emails, ads, video scripts, or briefs.
---

La description è ciò con cui l'agente effettua la corrispondenza. Se è vaga, la skill non si attiverà quando vuoi. Se è precisa, si attiva esattamente quando è rilevante.

Quando l'agente usa una skill

All'avvio della chat, l'agente visualizza l'elenco delle Skills disponibili (sia predefinite che dell'Area di lavoro) insieme alle loro descrizioni. Quando una richiesta corrisponde, legge il corpo prima di eseguire il lavoro.

• Scrivere una landing page → leggi ahrefs-brand-voice e ahrefs-design-manual.
• Generare un PDF → leggi PDF (obbligatorio; la sandbox blocca diverse librerie comuni).
• Chiamare un'API di terze parti → leggi connectors.
• Scrivere una pagina Console che chiama un LLM → leggi llm e pydantic.

Puoi anche forzare il caricamento di una skill: "usa la skill del tono di voce del brand prima di rispondere."

Dietro le quinte. Le Skills non sono magia. Sono markdown che l'agente decide di leggere in base a una corrispondenza della descrizione. Il costo è la lettura; il beneficio è la coerenza. Le skills predefinite provengono dallo store di sola lettura della piattaforma; le skills dell'Area di lavoro vivono nella tua Area di lavoro e sono tue da far evolvere. Se una regola deve applicarsi a una chat, dilla semplicemente in chat. Se deve applicarsi a ogni chat futura, inseriscila in una skill o nella memoria.