---
title: Agent skill
description: Install the Linkdash skill so Cursor, Claude Code, or Codex can create links, upload files, call the HTTP API, and connect MCP.
sidebar:
  label: Agent skill
  order: 2
---

The skill is the same `SKILL.md` agents fetch from the site and from npm.

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

Canonical file: [linkdash-skill on npm](https://www.npmjs.com/package/linkdash-skill). Website copy: [https://linkdash.dev/skills/linkdash/SKILL.md](https://linkdash.dev/skills/linkdash/SKILL.md).

After the skill is installed, the agent still needs the CLI (or an API key) to do any work. Install [`linkdash-cli`](https://www.npmjs.com/package/linkdash-cli); the command is `linkdash`. See [Quickstart](/quickstart).

## What the skill covers

- Create URL, file, and text links
- Update, pause, list, and delete
- Stats, CSV import/export
- Custom domains
- Account HTTPS webhooks
- HTTP API at `https://api.linkdash.dev/v1`
- MCP at `https://api.linkdash.dev/mcp`

## Agent rules (do not skip)

1. Parse CLI stdout as JSON. Do not pass `--json`.
2. Never invent flags, endpoints, or tokens.
3. Never confirm deletes unless the user asked for a confirmation step.
4. Never echo secrets (`--password`, tokens, API keys, webhook secrets).
5. If a command fails, read stderr or JSON `error` and fix flags.
6. Writes count toward the monthly event quota. Reads do not.

The CLI cannot change email, password, or billing. Send the user to [Billing](https://linkdash.dev/dashboard/billing) or [Settings](https://linkdash.dev/dashboard/settings). API keys (HTTP and MCP): [API keys](https://linkdash.dev/dashboard/keys).