---
title: Skill de agente
description: >-
  Instale a skill da Linkdash para que o Cursor, o Claude Code ou o Codex possam
  criar ligações, carregar ficheiros, chamar a API HTTP e ligar o MCP.
sidebar:
  label: Skill de agente
  order: 2
---
A skill é o mesmo `SKILL.md` que os agentes obtêm do site e do npm.

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

Ficheiro canónico: [linkdash-skill no npm](https://www.npmjs.com/package/linkdash-skill). Cópia do site: [https://linkdash.dev/skills/linkdash/SKILL.md](https://linkdash.dev/skills/linkdash/SKILL.md).

Depois de instalar a skill, o agente continua a precisar da CLI (ou de uma chave de API) para executar qualquer tarefa. Instale a [`linkdash-cli`](https://www.npmjs.com/package/linkdash-cli); o comando é `linkdash`. Consulte o [Início rápido](/pt/quickstart).

## O que a skill cobre

- Criar ligações de URL, de ficheiro e de texto
- Variantes: vários destinos numa mesma ligação, com pesos e condições para os visitantes (`--variant`, `links variants`, `--when`, `--sticky`)
- Atualizar, pausar, listar e eliminar
- Pastas: criar, mover, copiar e listar uma pasta (`--folder`, `--in`, `links move`, `links copy`)
- Acesso e partilha: restrito por predefinição, `--access link|public`, partilha por email (`links share`, `links shares`, `links unshare`, `links shared`, `links leave`, `links role`, `links unlock`, `links activity`, `links reset-link`)
- Estatísticas, importação e exportação em CSV
- Domínios personalizados
- Webhooks HTTPS da conta
- API HTTP em `https://api.linkdash.dev/v1`
- MCP em `https://api.linkdash.dev/mcp`

## Regras para agentes (não as ignore)

1. Interprete o stdout da CLI como JSON. Não passe `--json`.
2. Nunca invente flags, endpoints ou tokens.
3. Nunca confirme eliminações, a menos que o utilizador tenha pedido um passo de confirmação.
4. Nunca repita segredos (`--password`, tokens, chaves de API, segredos de webhooks).
5. Se um comando falhar, leia o stderr ou o `error` do JSON e corrija as flags.
6. As escritas contam para a quota mensal de eventos. As leituras não.
7. As novas ligações são restritas. Use `--access public` para ligações que serão publicadas em público e entregue ao utilizador o `url` impresso.

A CLI não consegue alterar o email, a palavra-passe nem a faturação. Encaminhe o utilizador para a [Faturação](https://linkdash.dev/dashboard/billing) ou para as [Definições](https://linkdash.dev/dashboard/settings). Chaves de API (HTTP e MCP): [Chaves de API](https://linkdash.dev/dashboard/keys).
