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
namedella 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.
