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

Install

npx skills add hoox-video/skill
Or install for a specific agent:
npx skills add hoox-video/skill -a cursor
The skill collection is hosted on GitHub at hoox-video/skill.

Example prompts

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.
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.
Use the Hoox API to list available voices filtered by language "en" and gender "female".
Also list avatars tagged for ecommerce, social, or UGC-style content.
Return the results in a table with ID, name, and tags so I can pick a brand ambassador style combo.
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.
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.
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.
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.

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
  • 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