Trova la cartella installata; modifica SKILL.md.
Apri la directory della skill su disco e modifica SKILL.md. È il file che gli host caricano. Tieni allineati il nome della cartella e il name del frontmatter quando l'host richiede la corrispondenza (Cursor e VS Code dicono entrambi che il nome deve coincidere con la cartella padre).
Descrizione in terza persona: cosa fa e quando usarla.
I campi obbligatori nello standard aperto sono name e description. La descrizione è come l'agente scopre la skill. Terza persona, trigger concreti, nessuna voce da helper in prima persona.
Tieni il body come procedura.
Scrivi passi che l'agente possa seguire. Sposta le note lunghe in un file di riferimento gemello un livello più in basso e collegalo dal body così il caricamento progressivo continua a funzionare.
Rievoca /skill-name o un prompt corrispondente.
In Claude, digita /skill-name. In Cursor, / e il nome della skill. In Codex, /skills o $ per menzionarla. Oppure chiedi in linguaggio naturale usando le stesse parole trigger della descrizione.
Non modificare Analog né .agents/skills dello shop.
Lascia in pace Analog e il .agents/skills interno di questo shop. Non sono il pack pubblico. Vedi How not to use portable skills.