---
title: Skill agente
description: >-
  Installa la skill Linkdash così Cursor, Claude Code o Codex possono creare
  link, caricare file, chiamare l'API HTTP e collegare MCP.
sidebar:
  label: Skill agente
  order: 2
---
La skill è lo stesso `SKILL.md` che gli agenti scaricano dal sito e da npm.

```bash
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
```

File canonico: [linkdash-skill su npm](https://www.npmjs.com/package/linkdash-skill). Copia sul sito: [https://linkdash.dev/skills/linkdash/SKILL.md](https://linkdash.dev/skills/linkdash/SKILL.md).

Dopo aver installato la skill, l'agente ha comunque bisogno della CLI (o di una chiave API) per fare qualsiasi operazione. Installa [`linkdash-cli`](https://www.npmjs.com/package/linkdash-cli); il comando è `linkdash`. Vedi [Quickstart](/it/quickstart).

## Cosa copre la skill

- Creare link di tipo URL, file e testo
- Varianti: più destinazioni su un singolo link con pesi e condizioni del visitatore (`--variant`, `links variants`, `--when`, `--sticky`)
- Aggiornare, mettere in pausa, elencare ed eliminare
- Cartelle: creare, spostare, copiare ed elencare una sola cartella (`--folder`, `--in`, `links move`, `links copy`)
- Accesso e condivisione: limitato per impostazione predefinita, `--access link|public`, condivisione via email (`links share`, `links shares`, `links unshare`, `links shared`, `links leave`, `links role`, `links unlock`, `links activity`, `links reset-link`)
- Statistiche, importazione/esportazione CSV
- Domini personalizzati
- Webhook HTTPS dell'account
- API HTTP su `https://api.linkdash.dev/v1`
- MCP su `https://api.linkdash.dev/mcp`

## Regole per l'agente (non saltarle)

1. Analizza lo stdout della CLI come JSON. Non passare `--json`.
2. Non inventare mai flag, endpoint o token.
3. Non confermare mai le eliminazioni, a meno che l'utente non abbia chiesto un passaggio di conferma.
4. Non ripetere mai segreti (`--password`, token, chiavi API, segreti dei webhook).
5. Se un comando fallisce, leggi stderr o il campo `error` del JSON e correggi i flag.
6. Le scritture contano nella quota mensile di eventi. Le letture no.
7. I nuovi link sono limitati. Usa `--access public` per i link che verranno pubblicati pubblicamente, e passa all'utente l'`url` stampato.

La CLI non può modificare email, password o fatturazione. Indirizza l'utente a [Billing](https://linkdash.dev/dashboard/billing) o [Settings](https://linkdash.dev/dashboard/settings). Chiavi API (HTTP e MCP): [API keys](https://linkdash.dev/dashboard/keys).
