> ## Documentation Index
> Fetch the complete documentation index at: https://www.vozo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills for Agents

> Use your AI agent to create, manage, and download Vozo video localization projects with natural-language prompts.

Vozo Skills let you ask your AI agent to handle video localization in Vozo using natural language. They work through Vozo CLI, which is installed during setup and connects your agent to Vozo so it can create projects, check progress, and download finished files for you—without requiring you to learn or run any commands.

## What You Can Do

Vozo Skills support four core localization tasks:

* **AI Dubbing**: Translate speech and create dubbed video or audio in another language.
* **Translate Subtitles**: Create translated subtitles or replace subtitles already visible in a video.
* **Visual Translate**: Translate on-screen text while preserving its visual presentation.
* **Lip Sync**: Match mouth movements to new or translated audio.

You can also ask your agent to:

* Process a local file, a folder of files, or a supported video URL
* Create several language versions or process multiple files in a batch
* Apply several Vozo tools as one workflow
* Check project status and find existing projects
* Export and download available videos, audio, and subtitle files

## Before You Start

You need:

* A Vozo account
* An AI agent that can use tools and files on your computer

Vozo Skills have been tested with Claude Code, Codex, OpenClaw, Cursor, WorkBuddy, and Hermes. Other AI agents that can run local tools may also work.

<Info>
  Projects created through Vozo Skills use the same Vozo account and [points system](/docs/common/tools-points-rules) as projects created in the Vozo web app. Before creating a project, your agent shows the estimated points and asks you to confirm.
</Info>

## Install Vozo Skills

The easiest way to get started is to copy the prompt below into your AI agent:

```text wrap theme={null}
Install vozoai/cli: https://raw.githubusercontent.com/vozoai/cli/main/installation-guide.md
```

Your agent will run the setup and tell you if it needs permission to use local tools.

During sign-in, Vozo opens a secure browser page. Complete the login there, then return to your agent so it can verify your account.

<Accordion title="Install from a terminal instead">
  If you prefer to run the setup yourself, open a terminal and enter:

  ```bash theme={null}
  npx @vozoai/cli@latest install
  ```

  After installation, return to your AI agent and ask it to sign you in to Vozo.
</Accordion>

## Create Your First Project

<Steps>
  <Step title="Share your source">
    Give your agent a local file, a folder, or a supported video URL. Make sure the agent can access the source on your computer.
  </Step>

  <Step title="Describe the result you want">
    Name the target language and the tasks to include, such as dubbing, subtitles, on-screen text translation, or lip sync. You can also describe preferred terminology, tone, and where to save the finished files.
  </Step>

  <Step title="Review and confirm the plan">
    Check the source, target language, selected tasks, and estimated points. Confirm only when the plan matches your request.
  </Step>

  <Step title="Let your agent run the workflow">
    Your agent creates the project, checks its progress, and starts an export when one is required. You can continue asking for status updates while it works.
  </Step>

  <Step title="Review or download the result">
    When processing is complete, your agent can download the available files to a location you choose. It can also give you a link to open the project in the Vozo web app.
  </Step>
</Steps>

## Prompt Examples

Use natural language and include the source, target language, and the result you want.

### Localize One Video

```text wrap theme={null}
Translate this video into Spanish with dubbing and translated subtitles. Keep product names in English, and save the finished video in my Downloads folder.
```

### Process a Folder

```text wrap theme={null}
Translate every video in this folder into Japanese. Include dubbing, on-screen text translation, and lip sync, then save all finished videos in a new folder.
```

### Create Several Language Versions

```text wrap theme={null}
Make English, French, and Spanish versions of this video with dubbing and subtitles. Show me the plan and estimated points before creating anything.
```

### Collect Completed Work

```text wrap theme={null}
Find my completed Vozo projects from last week and download the available final videos and subtitle files.
```

## Review and Edit in Vozo

Projects created through Vozo Skills also appear in your Vozo account. Ask your agent to open a project when you want to review it in the Vozo web app.

Vozo Skills currently focus on creating projects, checking progress, exporting results, and downloading files. To edit translations, change voices, redub content, or make other detailed changes, open the project in the Vozo web editor.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Do I need to know how to code?">
    No. Copy the installation prompt into your AI agent, and it will check your computer and guide you through the setup. After that, you can use Vozo Skills with plain-language requests.
  </Accordion>

  <Accordion title="Do Vozo Skills replace the Vozo web app?">
    No. Vozo Skills help your agent run supported workflows and repetitive tasks. Use the web app when you want to visually review a project or edit its content in detail.
  </Accordion>

  <Accordion title="Where can I find projects created by my agent?">
    They appear in the same Vozo account you used during sign-in. You can ask your agent to find or open a project, or browse your projects in the Vozo web app.
  </Accordion>

  <Accordion title="Why do subtitles in a video downloaded by my agent look different from what I see in the web app?">
    The Vozo web app remembers the subtitle style and position you previously used. This information is stored locally in your browser, so your AI agent cannot access it when creating a project. Projects created through an agent therefore use the default subtitle style.

    If subtitle appearance matters, ask your agent to create the project, then open it in the Vozo web app. Review and adjust the subtitle style and position before manually exporting and downloading the video.
  </Accordion>

  <Accordion title="Why aren't my web app edits included in the video downloaded by my agent?">
    Some edits in the Vozo web app require additional processing, such as regenerating speech or adding subtitles. If you do not wait in the browser until processing finishes, the latest changes cannot be synced to your AI agent.

    Your agent may then treat the project as unchanged and download the previous version instead of exporting a new video. After editing, keep the project open in the web app and wait for processing to finish. Then ask your agent to check the project again, export the latest version, and download it.
  </Accordion>

  <Accordion title="Do Vozo Skills use points?">
    Yes. Projects follow the same points rules as projects created in the Vozo web app. Your agent shows an estimate before creation and waits for your confirmation.
  </Accordion>
</AccordionGroup>