# Send Visla AI Video Creation to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "visla",
    "name": "Visla AI Video Creation",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/visla-admin/visla",
    "canonicalUrl": "https://clawhub.ai/visla-admin/visla",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/visla",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=visla",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/visla_cli.sh",
      "scripts/visla_cli.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "visla",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T23:44:37.200Z",
      "expiresAt": "2026-05-07T23:44:37.200Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=visla",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=visla",
        "contentDisposition": "attachment; filename=\"visla-1.0.3.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "visla"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/visla"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/visla",
    "downloadUrl": "https://openagent3.xyz/downloads/visla",
    "agentUrl": "https://openagent3.xyz/skills/visla/agent",
    "manifestUrl": "https://openagent3.xyz/skills/visla/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/visla/agent.md"
  }
}
```
## Documentation

### Visla Video Generation

Version: 260218-1410

Create AI-generated videos from text scripts, web URLs, or documents (PPT/PDF) using Visla's OpenAPI.

### Before You Start

Credentials (NEVER output API keys/secrets in responses):

IMPORTANT: Only read local credential files with explicit user consent.

Ask the user for permission before reading ~/.config/visla/.credentials
If permission is granted and the file exists with valid credentials, use --credentials-file ~/.config/visla/.credentials with the Python CLI. The Bash CLI does not support --credentials-file, so use environment variables instead.
If permission is denied, missing, or invalid, ask the user for credentials

Only process local files (scripts/docs) explicitly provided by the user, and remind users to avoid uploading sensitive data.

Tell the user: this is a one-time setup (once configured, they won't need to do this again)
Tell the user: get API Key and Secret from https://www.visla.us/visla-api
Ask for the API key/secret explicitly (or ask the user to update the file and confirm). Do not repeat the secrets back in the response.

Credential validity check (practical):

If credentials exist but running account fails with VISLA_CLI_ERROR_CODE=missing_credentials or VISLA_CLI_ERROR_CODE=auth_failed, treat credentials as invalid and ask the user to provide real ones.

File format (bash/zsh):

export VISLA_API_KEY="your_key"
export VISLA_API_SECRET="your_secret"

For PowerShell (temporary session):

$env:VISLA_API_KEY = "your_key"
$env:VISLA_API_SECRET = "your_secret"

Scripts: scripts/visla_cli.py (Python), scripts/visla_cli.sh (Bash)

### Platform Execution

Default strategy:

Prefer Bash on macOS when dependencies are available (the Bash CLI avoids Python SSL-stack issues on some macOS setups).
Prefer Python when you're already using a well-configured Python (or when Bash dependencies are missing).

Bash (recommended on macOS; also works on Linux-like environments):

# With user consent, you may source ~/.config/visla/.credentials
export VISLA_API_KEY="your_key"
export VISLA_API_SECRET="your_secret"
./scripts/visla_cli.sh <command>

Python (cross-platform):

python3 scripts/visla_cli.py --key "your_key" --secret "your_secret" <command>
# Or, with user consent:
python3 scripts/visla_cli.py --credentials-file ~/.config/visla/.credentials <command>

Windows native (PowerShell/CMD without Bash; Python):

# PowerShell
$env:VISLA_API_KEY = "your_key"
$env:VISLA_API_SECRET = "your_secret"
python scripts/visla_cli.py <command>

Windows note:

The agent should prefer running the Python CLI on Windows unless it has verified a Bash environment (WSL/Git Bash) is available.
For simple scripts, pass directly: python scripts/visla_cli.py script "Scene 1: ..."
For multi-line or complex scripts, use stdin with - (recommended, no temp files):
@"
Scene 1: ...
Scene 2: ...
"@ | python scripts/visla_cli.py script -


If you have Python Launcher installed, py -3 scripts/visla_cli.py <command> may work better than python.
Credentials:

The Python CLI only reads a credentials file if --credentials-file is explicitly provided.
On Windows the default path is typically: %USERPROFILE%\\\\.config\\\\visla\\\\.credentials.

Note: do not print credentials. Prefer environment variables or --credentials-file with explicit user consent.

### Commands

CommandDescription/visla script <script-or-@file>Create video from a script (text or a local file)/visla url <URL>Create video from web page URL/visla doc <file>Create video from document (PPT/PDF)/visla accountShow account info and credit balance

Source of truth for the exact CLI surface: run scripts/visla_cli.sh --help or python3 scripts/visla_cli.py --help.

### Script Format

**Scene 1** (0-10 sec):
**Visual:** A futuristic calendar flipping to 2025 with digital patterns.
**Narrator:** "AI is evolving rapidly! Here are 3 game-changing AI trends."

**Scene 2** (10-25 sec):
**Visual:** Text: "Trend #1: Generative AI Everywhere." Show tools like ChatGPT.
**Narrator:** "Generative AI is dominating industries—creating content and images."

### Workflow

The script, url, and doc commands execute the complete flow automatically:

Create project
Poll until generation completes (may take a few minutes)
Auto-export and return download link

Execution Instructions:

Inform user that video generation takes some time
Report progress status periodically during polling

### Timeout Guidance

This workflow typically takes 3-10 minutes, but can take up to ~30 minutes in the worst case. Set the task/command timeout to >= 30 minutes (Windows defaults are often ~10 minutes and need to be increased). If you cannot change the timeout, warn the user up front and, on timeout, ask whether to continue or switch to a step-by-step run.
If timeout occurs, the CLI returns project_uuid in the output. Inform the user they can manually check project status and continue later using the Visla web interface or API.

### Examples

/visla script @myscript.txt
/visla script "Scene 1: ..."
/visla url https://blog.example.com/article
/visla doc presentation.pptx
/visla account

### Supported Document Formats

PowerPoint: .pptx, .ppt
PDF: .pdf

### Output Format

Start: Display "Visla Skill v260218-1410" when skill begins
End: Display "Visla Skill v260218-1410 completed" when skill finishes
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: visla-admin
- Version: 1.0.3
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T23:44:37.200Z
- Expires at: 2026-05-07T23:44:37.200Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/visla)
- [Send to Agent page](https://openagent3.xyz/skills/visla/agent)
- [JSON manifest](https://openagent3.xyz/skills/visla/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/visla/agent.md)
- [Download page](https://openagent3.xyz/downloads/visla)