← DocsMarkdownAccedi

Guida per agent

Istruzioni concise per agent di coding che usano MCP.

Sei collegato a Skillkren, una libreria di skill di IA riutilizzabili ed esempi del loro output. 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 Skillkren. Dominio: skillkren.tech.

Primi passi

  1. Chiama get_docs con topic agent (o leggi la resource https://skillkren.tech/docs/agent.md) se ti serve un ripasso.
  2. Usa list_skills per controllare le skill dell'utente e le librerie dei suoi team prima di creare duplicati. Per aprire la skill condivisa di qualcun altro, usa get_skill con l'id dal suo link.
  3. Nel piano Free un utente può salvare fino a 25 skill; upsert_skill restituisce un errore al limite. Non aggirarlo.
  4. Usa upsert_skill con un titolo chiaro. Aggiorna la tua skill con quel titolo, oppure ne crea una nuova. Passa team per lavorare in una libreria di team.
  5. Allega sempre almeno un esempio quando pubblichi una skill nuova (add_example).

Usare una skill

  1. Caricala con get_skill e segui le sue istruzioni.
  2. get_skill elenca i files inclusi per percorso. Leggine uno con get_skill_file solo quando le istruzioni lo indicano o il compito lo richiede.
  3. 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/ con put_skill_file, e nomina ogni file con il suo percorso nelle istruzioni, es. "For banned words, read references/banned-words.md". Template e dati vanno in assets/, codice eseguibile in scripts/.
  • 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 compatibility solo 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/):

  1. Leggi SKILL.md. Usa il suo name (come titolo leggibile), description e license; il corpo dopo il frontmatter è il content.
  2. Chiama upsert_skill con quei campi. Se la cartella ha un file LICENSE, passa il suo testo come licenseText.
  3. Per ogni file sotto references/, scripts/ e assets/, chiama put_skill_file con lo stesso percorso relativo, es. references/forms.md.
  4. 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.
  5. 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 (solo il proprietario). Le skill Non in elenco possono essere aperte da chiunque abbia il link; le Pubbliche sono anche elencate sul profilo del proprietario a https://skillkren.tech/u/<username>.

Non puoi cambiare la visibilità. Se l'utente vuole condividere una skill, mandalo alla sua pagina e digli di usare l'interruttore accanto al titolo. Non suggerire mai di condividere una skill con segreti al suo interno.

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://skillkren.tech/app
  • Skill: usa la url restituita dalle tools. Sembra https://skillkren.tech/u/<username>/skills/<id>.
  • Esempi: l'URL della skill più /examples. Riferimenti: l'URL della skill più /references.
  • Docs: https://skillkren.tech/docs
  • Doc agente (grezzo): https://skillkren.tech/docs/agent.md

Cosa non fare

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