Velk is made to be used by talking to an AI. That AI is Claude Code, Anthropic's assistant that works on the files of a project: it reads and writes them and runs commands on your computer, and you approve what it does.
On its own, Claude doesn't know Velk. The Velk skill is the package of knowledge that teaches it: how site.json works, which fields exist, and the step-by-step flows to install, publish, update and back up a site. You install it once and it serves every Velk project on that computer.
Get Claude Code
Claude Code comes in a few forms that do the same work. If you don't live in the terminal, use the desktop app: download it at claude.ai/download, install it like any program and sign in with your Claude account. Claude Code is the app's Code tab: you choose the project's folder and talk.
The terminal version and the VS Code and JetBrains extensions run the same assistant, and everything on these pages applies to them. Pick one and stay with it while you learn; switching later costs nothing.
Ask the AI
Install the Velk skill from skill.velkcms.com
Type it in Claude Code, in any folder. The AI installs it once, as a Claude plugin, and every project sees it.
/plugin install velk --marketplace elleven-digital/velk-skill in a Claude Code conversation, or add the marketplace elleven-digital/velk-skill in the app, under Customize → Plugins.What's inside
The skill isn't a program with buttons. It is a set of instructions the AI reads before acting:
- An orientation on how Velk works: the structure in
site.json, the theme in plain PHP, the engine nobody edits. - A guide per task: building, multiple languages, installing, updating the engine, publishing, access files for clients, editing live content, converting HTML into a theme and backups.
- Tested scripts for everything that talks to a server over SSH (the encrypted connection to your hosting). Publishing, copying a live site or backing it up runs the same way every time instead of being improvised.
No sub-commands
There is no velk deploy or velk install to memorize. You say what you want in your own words and the skill picks the flow. Variations work too: it reads the intent, not a syntax. It comes in on its own when the request mentions Velk or when the folder is a Velk project; in an empty folder, name it (“Install Velk here”).
Phrases that work
| You want to | You can say |
|---|---|
| Install Velk in an empty folder | “Install Velk here” |
| Put a site online for the first time | “Publish this site on Hostinger” |
| Publish changes to the theme | “Publish the theme changes” |
| Bring the live site to your computer | “Bring the production site to my computer” |
| Update the engine | “Update Velk to the latest version” |
| Change content on the live site | “Create a post about our new opening hours on the live site” |
| Back up a site | “Make a backup of the production site” |
| Turn an HTML site into a theme | “Convert this HTML into a Velk theme” |
| Give a client access to a site | “Create an access file for this site” |
Skill or `bin/velk`?
| The Velk skill | The `bin/velk` command |
|---|---|
| Knowledge the AI reads: how Velk works and the flow for each task. | A tool that comes with the engine in every project, with real commands such as schema:validate, migrate and serve. |
| Installed once in Claude, as a plugin: one copy for all projects. | Lives in the project's bin/ folder and is updated with the engine. |
| You talk to it in plain words. | The AI runs it for you and shows the result; you never have to type it. |
Ask the AI
Update the Velk skill and tell me which version is installed now.
Do it now and then, and before a big job such as a first deploy or an engine update: what each new Velk version requires is written in the skill.
Do I need to know how to program?
No. You describe what you want and the AI writes the structure, the templates and the commands. What you need is the habit of reading what it proposes; see Talking to the AI.
Does it cost anything?
The skill is free and open source (MIT license). Claude Code is used with a Claude account; claude.ai shows which plans include it.
Can I use another AI assistant?
The skill is made for Claude Code. Every Velk project also carries AGENTS.md, the engine's reference for AI agents, which other assistants can read; the flows on these pages come from the skill.
An older guide installs the skill into ~/.claude/skills/velk. Does that still work?
Yes: that's the package, the same skill without updates through Claude. The plugin is better; after installing it, delete the ~/.claude/skills/velk folder so only the plugin's copy loads.