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:
npx skills add velvenai/skillsOr install one skill by name:
npx skills add velvenai/skills --skill onboardThe 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”. |
- Skill
onboard- What it does
- 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. 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 in one install. Add the marketplace:
claude plugin marketplace add velvenai/skillsThen 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: publishing with the CLI or the MCP server, listing and claiming a space.
- https://velven.ai/docs/cli.md: every command of the Velven CLI.
- https://velven.ai/docs/sdk.md: sign-in, leaderboards and saves inside the space.
- https://velven.ai/llms.txt: the index an agent or a crawler reads first.
On the add page, 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.