# Agent skills

A skill is a set of instructions a coding agent loads when a task matches. Install Velven's skill and your agent can list a space, claim one, and add sign-in and a leaderboard without you copying anything by hand. It works with Claude Code, Cursor, Codex, Copilot and any other agent that reads skills.sh.

## Install

Run this in the project's folder:

```bash
npx skills add velvenai/skills
```

Or install one skill by name:

```bash
npx skills add velvenai/skills --skill onboard
```

The skills CLI puts each skill where the agent in that folder reads it. From then on the agent uses a skill whenever you ask for something it covers; you never call it by name.

## Available skills

Velven has one skill so far:

| Skill | What it does |
| --- | --- |
| `onboard` | Lists your space on Velven, or claims one Velven listed: it signs in as you, adds the proof tag to your site, fills in the page from your project and can move the listing to a new address. When your space keeps a score or progress, it adds the Velven SDK and sets up leaderboards and saves. Your agent uses it when you ask for things like “list on Velven”, “put this on Velven”, “claim my space”, “add a leaderboard”, “high scores”, “sign in players”, “save progress”, “Velven SDK”. |

> Note: The source is public at [github.com/velvenai/skills](https://github.com/velvenai/skills). A skill is a folder with a SKILL.md; read it before installing, as with any code an agent will run.

## The Claude Code plugin

In Claude Code, Velven's plugin brings the skills and [Velven's MCP server](https://velven.ai/docs/agent#mcp) in one install. Add the marketplace:

```bash
claude plugin marketplace add velvenai/skills
```

Then run `/plugin` in Claude Code and install Velven from the list. The MCP server asks you to sign in to Velven the first time a tool needs your account.

## Without skills

An agent that reads no skills gets the same flow from the plain-text docs. Every guide here is also served as markdown:

- [https://velven.ai/docs/agent.md](https://velven.ai/docs/agent.md): publishing with the CLI or the MCP server, listing and claiming a space.
- [https://velven.ai/docs/cli.md](https://velven.ai/docs/cli.md): every command of the Velven CLI.
- [https://velven.ai/docs/sdk.md](https://velven.ai/docs/sdk.md): sign-in, leaderboards and saves inside the space.
- [https://velven.ai/llms.txt](https://velven.ai/llms.txt): the index an agent or a crawler reads first.

On the [add page](https://velven.ai/add), pick “With your agent”, then press “Copy instructions for my agent”. It puts a paragraph on your clipboard to paste into any agent's chat. The paragraph names the same endpoints and the SDK guide.