Cursor skill

Cursor-only playbook that tells the agent when to call Velkin MCP tools.

Cursor only

A Cursor skill is a short playbook at .cursor/skills/velkin/SKILL.md. It tells the agent when to call MCP tools. Skip this page on VS Code or Claude — use MCP + AGENTS.md there.

AI docs: MCP · AGENTS.md · Cursor skill · llms.txt

Install

npx velkin-mcp init --client cursor
# → .cursor/mcp.json
# → .cursor/skills/velkin/SKILL.md
# → AGENTS.md

create-velkin-app writes the same skill. Commit the project skill so the team shares one playbook.

What it should say

Unknown UI need → suggest_component
Named component → get_velkin_component_docs (compact: true)
Starter → get_component_usage / get_recipes
Before merge → validate_component_usage + velkin_lint
Hard rules: subpath imports, onVu* + e.detail, radius="full"

Full template: @velkin/mcp → templates/SKILL.md.

Next steps