Docs · Skills
Agent skills
An agent skill is a packaged set of instructions a coding agent loads when a task matches: what to do, in what order, with which calls. Velven publishes its skills in the skills.sh format, so Claude Code, Cursor, Codex, Copilot and the other agents that read it can list a space, claim one, and add sign-in and a leaderboard without a person copying anything by hand.
Plain text: /docs/skills.md
Installing skills
One command, from the project's folder, with the skills CLI:
npx skills add velvenai/skillsTo install one skill from the repository by name:
npx skills add velvenai/skills --skill onboardThe CLI puts the skill where the agent in that folder reads it (Claude Code, Cursor, Codex, GitHub Copilot, Cline and the rest of the agents on skills.sh). After that the agent picks the skill up on its own when the creator says something it is for; nothing is invoked by name.
The skills
| Skill | What it does | Install |
|---|---|---|
onboard | Lists a browser-playable space on Velven for its creator, or claims one Velven listed itself: the device-code login, the proof on the site, provenance filled from the project, the submit or the verify, the badge. Adds the SDK when the space keeps a score: the boards block, the tier, the secret, the moderation calls. Triggers: "list on Velven", "put this on Velven", "claim my space", "add a leaderboard", "high scores", "sign in players", "Velven SDK". | npx skills add velvenai/skills --skill onboard |
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.
Without a skill
An agent that reads no skills gets the same flow from the plain-text docs, which every guide here is also served as:
https://velven.ai/docs/agent.md: listing and claiming a space.https://velven.ai/docs/sdk.md: sign-in and leaderboards inside the space.https://velven.ai/llms.txt: the index an agent or a crawler reads first.
A creator can also press "Copy instructions for my agent" on the home page or the add page and paste the paragraph into any agent's chat; it names the same endpoints and the SDK guide.