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

# Agent Skills

> Install the Hoox agent skill into Cursor, Claude Code, or Windsurf

Agent skills give AI coding assistants (Cursor, Claude Code, Windsurf, etc.) deep knowledge of the Hoox API through a reusable, installable guide.

### Install

```bash theme={null}
npx skills add hoox-video/skill
```

Or install for a specific agent:

<CodeGroup>
  ```bash Cursor theme={null}
  npx skills add hoox-video/skill -a cursor
  ```

  ```bash Claude Code theme={null}
  npx skills add hoox-video/skill -a claude-code
  ```
</CodeGroup>

<Info>
  The skill collection is hosted on GitHub at [hoox-video/skill](https://github.com/hoox-video/skill).
</Info>

### Example prompts

<AccordionGroup>
  <Accordion title="Generate a video from a prompt">
    ```text theme={null}
    Use the Hoox API to generate a 60-second vertical product demo video for our new DTC skincare serum.
    Voice: use an English female conversational voice that feels like a creator.
    Avatar: use an avatar that looks like a lifestyle content creator.
    Highlight 3 key benefits, include one short testimonial quote, and end with a clear "Shop now" call-to-action.
    Export the final video to MP4 and return the download URL.
    ```
  </Accordion>

  <Accordion title="Generate a script">
    ```text theme={null}
    Use the Hoox API to generate a 90-second video script announcing our new loyalty program for our Shopify store.
    Duration: 90 seconds.
    Focus on benefits for repeat customers, how to earn points, and a limited-time launch bonus.
    Return the script text and estimated cost.
    ```
  </Accordion>

  <Accordion title="List voices and avatars">
    ```text theme={null}
    Use the Hoox API to list available voices filtered by language "en" and gender "female".
    Also list avatars filtered by place, action, emotion, and accessories.
    Return the results in a table with ID, name, and metadata so I can pick a brand ambassador style combo.
    ```
  </Accordion>

  <Accordion title="Export a video">
    ```text theme={null}
    Use the Hoox API to export video VIDEO_ID to MP4 in vertical format.
    Poll the export status until complete and return the download URL.
    ```
  </Accordion>

  <Accordion title="Generate a batch of assets into a dedicated folder">
    ```text theme={null}
    Use the Hoox API to generate 4 product hero images for our "Summer Drop" campaign.
    Create a dedicated asset folder for the campaign first, then generate every image into it.
    Then animate the best one into a short video — keep it linked to the source image in the
    dashboard history. Return the asset IDs grouped by folder.
    ```
  </Accordion>

  <Accordion title="Create a custom avatar">
    ```text theme={null}
    Use the Hoox API to create a custom avatar.
    Prompt: "A young lifestyle creator filming TikTok videos in a cozy living room, talking about home decor products"
    Style: iphone, format: vertical.
    Set up a webhook at https://my-server.com/webhook to receive the result.
    ```
  </Accordion>

  <Accordion title="Duplicate a video with a different voice">
    ```text theme={null}
    Use the Hoox API to duplicate video VIDEO_ID with a new voice.
    Pick a male English voice with a British accent.
    Then export the duplicated video to MP4.
    ```
  </Accordion>

  <Accordion title="Full workflow with webhook">
    ```text theme={null}
    Use the Hoox API to:
    1. Generate a 60-second script announcing our Black Friday sale for our online fashion store
    2. Start video generation with the script, a friendly female voice, and an avatar that looks like a fashion creator
    3. Use webhook URL https://my-server.com/hook for both generation and export
    4. Start the export once generation completes
    Return all job IDs so I can track them.
    ```
  </Accordion>
</AccordionGroup>

### What the skill covers

When you install the skill, your coding assistant gains access to a detailed guide covering:

* **Authentication** — How to configure the API key and rate limits
* **Video creation workflow** — The complete pipeline from script to MP4
* **All API endpoints** — Request/response formats for every endpoint
* **Asset organization & lineage** — Grouping batches in dedicated folders and preserving edit history with `parent_media_id`
* **Polling strategies** — Recommended intervals for generation and export status checks
* **Webhooks** — How to receive async notifications instead of polling
* **Error handling** — Error codes and recovery strategies
* **Credit system** — Cost estimation and tracking