Sei collegato a Skillvad, una biblioteca di skill personale e di team (non un marketplace né uno store). Le skill pubbliche possono apparire su un profilo; è condividere, non una vetrina. Le skill seguono il formato aperto Agent Skills: un SKILL.md (istruzioni con frontmatter name e description), più file opzionali in references/, scripts/ e assets/.
Nome del brand: sempre Skillvad. Dominio: skillvad.tech.
Primi passi
- Chiama
get_docscon topicagent(o leggi la resourcehttps://skillvad.tech/docs/agent.md) se ti serve un ripasso. - Usa
list_skillsper controllare le skill dell'utente e le librerie dei suoi team prima di creare duplicati. Per aprire la skill condivisa di qualcun altro, usaget_skillcon l'id dal suo link. - Nel piano Free un utente può salvare fino a 25 skill;
upsert_skillrestituisce un errore al limite. Non aggirarlo. - Etichetta agente (una volta per conversazione): prima del primo
upsert_skill, proponi un'etichetta breve (es.Cursor on Mac,Claude Desktop) e chiedi all'utente di confermarla o modificarla. Non creare né aggiornare una skill finché non conferma. Poi passa quel valore comeagentLabelin ogniupsert_skillper il resto della conversazione. - Usa
upsert_skillcon un titolo chiaro. Aggiorna la tua skill con quel titolo, oppure ne crea una nuova. Passateamper lavorare in una biblioteca di team. - Allega sempre almeno un esempio quando pubblichi una skill nuova (
add_example).
Usare una skill
- Caricala con
get_skille segui le sue istruzioni. get_skillelenca ifilesinclusi per percorso. Leggine uno conget_skill_filesolo quando le istruzioni lo indicano o il compito lo richiede.- Usa gli esempi della skill come riferimento per formato, tono e qualità.
Scrivere una buona skill
- Description: cosa fa la skill e quando usarla, con le parole che un utente direbbe davvero. Gli agenti decidono se caricare una skill solo da questo.
- Instructions (
content): Markdown grezzo, non HTML. Passi, regole e come appare un buon output. Tienilo sotto circa 500 righe. - References: sposta il materiale lungo (guide di stile, note API, checklist) in
references/conput_skill_file, e nomina ogni file con il suo percorso nelle istruzioni, es. "For banned words, readreferences/banned-words.md". Template e dati vanno inassets/, codice eseguibile inscripts/. - License: imposta
license(es.MIT,Apache-2.0,CC-BY-4.0,Proprietary) solo quando l'utente ne sceglie una. Chiedi; non scegliere al posto suo. - Requirements: imposta
compatibilitysolo se la skill necessita di strumenti o accessi specifici.
Caricare una cartella skill
Quando l'utente ti chiede di caricare una skill locale (ad esempio ~/.claude/skills/pdf-processing/):
- Leggi
SKILL.md. Usa il suoname(come titolo leggibile),descriptionelicense; il corpo dopo il frontmatter è ilcontent. - Chiama
upsert_skillcon quei campi. Se la cartella ha un file LICENSE, passa il suo testo comelicenseText. - Per ogni file sotto
references/,scripts/eassets/, chiamaput_skill_filecon lo stesso percorso relativo, es.references/forms.md. - Solo file di testo fino a 100 KB ciascuno, 30 per skill, una sottocartella di profondità. Salta i binari (immagini, PDF) e indica all'utente quali file hai saltato.
- Dai all'utente il link della skill quando hai finito.
Nell'altra direzione, l'utente può scaricare qualsiasi skill come zip dalla sua pagina e scompattarla nella cartella skills della sua app.
Visibilità
Le skill nuove sono Privata di default (solo il proprietario). Passa team senza visibility per creare in una biblioteca di team.
Il proprietario può impostare visibility su upsert_skill a private, unlisted, public o team (con lo slug del team). Omettila negli aggiornamenti per non cambiarla. Cambiala solo se l'utente lo chiede. Non condividere mai una skill con segreti. Non in elenco è aperta con il link; Pubblica compare anche sul profilo a https://skillvad.tech/u/<username>.
Contesto di autenticazione
La tua connessione appartiene a un utente. Tutto ciò che crei è di proprietà di quell'utente, e puoi cambiare solo ciò che quell'utente può cambiare.
URL da citare
- App:
https://skillvad.tech/app - Skill: usa la
urlrestituita dalle tools. Sembrahttps://skillvad.tech/u/<username>/skills/<id>. - Esempi: l'URL della skill più
/examples. Riferimenti: l'URL della skill più/references. - Docs:
https://skillvad.tech/docs - Doc agente (grezzo):
https://skillvad.tech/docs/agent.md
Cosa non fare
- Non chiamare Skillvad un marketplace, uno store di skill, o un posto dove comprare skill. È una biblioteca.
- Non eliminare skill o file a meno che l'utente non lo confermi.
- Non incollare segreti in skill, file o esempi.
- Non fare affidamento sul rendering lato client; memorizza il sorgente Markdown.
