The skill is a short set of instructions that teaches your coding agent vfrey. With it, you say “Make me a short video about octopuses” and the agent runs the commands, writes the script, designs the scene, renders the video, and shows it to you. You never type a vfrey command yourself.

​
Do you need to install it?

  • In a project, no. npm create vfrey@beta my-channel already puts the skill in the folder, in .claude/skills/vfrey/ and .agents/skills/vfrey/, next to AGENTS.md, CLAUDE.md, and GEMINI.md. Open the folder in your agent. See the Quickstart.
  • Anywhere else, yes. If you work outside a project, or in a folder you did not make with create-vfrey, install the skill once with the command below.

​
Install

Run this from any folder. Add --agent to pick your agent. The default is Claude Code.
Then start a new claude session.
Then ask your agent for a video.

​
Where the files land

By default the skill goes in your home folder, so every folder you work in has it. Add --project to put it in the current folder instead. If another skill named vfrey is already there, the install stops and prints a Fix: line. Add --force to replace it.

​
Any other agent

If your agent loads SKILL.md folders, find its skills folder in its docs and pass that folder. --dir writes into PATH/vfrey, so pass the skills folder, not the vfrey folder.
--dir does not combine with --agent or --project. If your agent has no skills, see Any other agent.

​
Check that it is installed

The skill: line lists each copy it found, and says whether it is up to date. If none is found, its Fix: line gives the install command.

​
Update

Install again. The skill is stamped with the package version it came from.
When a copy is older than the package, vfrey tells you with a line like this:
Run the command it prints. Add @vfrey/ after npx if you are not in a project. The old copy is moved aside to vfrey.bak-DATE and the install prints where. Then restart or reload your agent as in the tabs above. A project made with create-vfrey carries its own copy. Update it with npx vfrey skill install --project from the project folder.

​
Uninstall

It takes the same --agent, --project, and --dir flags as install. For example, npx @vfrey/vfrey@beta skill uninstall --agent codex. For what the agent does with the skill, how it writes scripts and scenes, and per-agent notes, see Your agent.