AgentCloud
AgentCloud
Back to all skills

Create your skill in 10 minutes

A skill is a folder of instructions that teaches an agent how to do a type of work well. There is only one file that matters: SKILL.md. Start from the template, write when the skill should trigger, upload it: the agent uses it on its own when the request matches.

Download the template
  1. 1

    Download the template

    Start from SKILL.md already wired: frontmatter, sections and notes are in place. Rename the folder with your skill slug.

  2. 2

    Write the description (the part that matters)

    The agent only sees name and description until it knows the skill is relevant. Write what it does AND when to use it, with concrete triggers: "use when the customer asks for an order status".

  3. 3

    Fill in procedure, rules and output

    The procedure is the step-by-step the agent follows. Rules are the constraints (tone, tax, limits, GDPR). Expected output is the exact format: without it every answer differs.

  4. 4

    Zip it and upload

    Zip the folder (SKILL.md required; references/, templates/, examples/ optional) and drop it in the "Upload your skill" section on /skills. Validation runs server-side and tells you what to fix.

  5. 5

    Install it on the agent

    From the agent page open the Skills tab and install yours. From then on the skill enters the agent context, within the permissions of the connected integrations.

What the validator checks

  • SKILL.md must open and close the frontmatter with ---, with name, description, version, risk_level.
  • The body cannot exceed 500 lines: long references go in references/.
  • No API keys, tokens or Authorization headers: the file ends up in the agent context.
  • Scripts may only do local computation: no external links, remote shell or environment access.
  • Declare the permissions you use; the agent applies them only if the integration is connected, otherwise the skill works in reduced mode.
  • With risk_level: high every action with an external effect asks for your explicit approval.

500 righe · 256 KB per SKILL.md · 5 MB per pacchetto

Security and privacy

The skills you upload are private to your account: they do not appear in the public catalog and other users cannot see them. Every skill still stays within the agent permissions: if an integration is not connected, the skill cannot write to it.

The full template

---
name: la-mia-competenza
description: >
  Cosa fa la competenza e QUANDO usarla, con i trigger espliciti.
  Questo è il testo che l'agente legge per decidere se attivarla: se qui
  scrivi "quando serve fare X", l'agente la userà quando gli chiedi X.
version: 1.0.0
locale: it
agents: [nome-agente-dove-usarla]
integrations_required: []
integrations_optional: []
permissions: [read:contesto]
risk_level: low
---

# La mia competenza

Una riga che dice cosa ottiene l'utente quando questa competenza si attiva.

## Quando usarla

- La richiesta riguarda direttamente questo compito.
- I dati necessari sono disponibili nelle integrazioni collegate.

## Quando NON usarla

- Il compito esce dagli ambiti descritti sopra.
- Un'altra competenza copre già la richiesta.

## Procedura passo-passo

1. Raccogli gli input necessari dalla richiesta.
2. Leggi i dati dalle integrazioni collegate.
3. Applica le regole della sezione successiva.
4. Restituisci l'output nel formato dichiarato.

## Regole e vincoli

- Tono: professionale, diretto, orientato al risultato.
- Nessun dato inventato: se il dato manca, dichiaralo.
- GDPR: solo i dati necessari, mai segreti in questo file.

## Output atteso

Una riga che descrive il formato esatto di ciò che l'agente deve restituire.

## Esempi

**Richiesta**: «una richiesta tipica dell'utente»

```
l'output atteso, nell'esempio
```

---

# Note per chi scrive

- `name` deve essere kebab-case e univoco.
- `description` è il campo più importante: è l'unico testo sempre presente
  nel contesto dell'agente. Scrivi cosa fa E quando usarla.
- Il corpo sotto i 500 righe. Quello che eccede va in `references/`.
- `risk_level: high` fa sì che ogni azione con effetto esterno (invio,
  pubblicazione, pagamento, cancellazione) chieda l'approvazione umana.
- La competenza non può mai usare un'integrazione non collegata all'agente.