← DocsMarkdownAccedi

Skill ed esempi

Crea, copia e organizza skill ed esempi.

Skillkren segue il formato aperto Agent Skills usato da Claude, Codex, Cursor e altri. Una skill è una cartella:

pdf-processing/
├── SKILL.md        instructions (required)
├── LICENSE.txt     license terms (optional)
├── references/     docs the agent reads only when needed
├── scripts/        code the agent can run
└── assets/         templates and data

Una skill

  • Titolo: diventa il name della cartella (minuscolo, con trattini) all'export.
  • Descrizione (obbligatoria): cosa fa la skill e quando usarla. Gli agenti leggono questo per primi per decidere se caricare la skill, quindi nomina le situazioni e le parole chiave.
  • Istruzioni: il corpo di SKILL.md, in Markdown. Tienilo sotto circa 500 righe e sposta il materiale lungo nei riferimenti.
  • Tag (opzionale).
  • Licenza (opzionale): MIT, Apache 2.0, CC BY 4.0, CC0, Proprietary, o qualsiasi altra. Aggiungi i termini completi e vengono esportati come LICENSE.txt.
  • Requisiti (opzionale): solo se la skill necessita di strumenti o accessi specifici, es. "Needs Python 3.12 and internet access". Esportato come compatibility.
  • Visibilità: Privata (il valore predefinito), un team, Non in elenco o Pubblica. Vedi /docs/visibility.

Incolla un intero SKILL.md quando crei una skill e titolo, descrizione e licenza vengono compilati dal suo frontmatter.

URL stabile: /u/<username>/skills/<uuid>

Riferimenti e altri file

Apri la scheda References di una skill per aggiungere file sotto references/, scripts/ o assets/. Menziona ciascuno in SKILL.md con il suo percorso (ad esempio "For the full style rules, read references/style-guide.md") così l'agente sa quando aprirlo. Solo file di testo, fino a 100 KB ciascuno e 30 per skill.

Esempi

Gli esempi appartengono a una skill e mostrano output reale. Sono ciò che rende una skill affidabile: un collega o un agente può vedere esattamente come appare qualcosa di "buono".

  • Indice: /app/skills/<uuid>/examples
  • Dettaglio: /app/skills/<uuid>/<example-slug>

Cronologia delle versioni

Ogni modifica alle istruzioni, alla descrizione, ai tag o alla licenza salva una versione numerata. Il piano Free mostra le ultime 2; Pro e Team le mostrano tutte.

Copia, download, installazione

  • Copy skill copia le istruzioni esatte di SKILL.md.
  • Download .zip ti dà l'intera cartella (SKILL.md con frontmatter, LICENSE.txt, riferimenti).

Per installare un download:

  • Claude (app): Settings → Capabilities → Skills → carica lo zip.
  • Claude Code: decomprimi in ~/.claude/skills/ (o .claude/skills/ in un progetto).
  • Codex / Cursor / altri: decomprimi nella cartella skills dell'app (ad esempio ~/.codex/skills/).

Oppure salta il download e collega il tuo agente via MCP, così legge sempre l'ultima versione. Vedi /docs/connectors.