Skip to main content

​
Overview

A Skill File is a markdown file that teaches AI agents (Claude, Cursor) how to use the Hooked Video API. Once installed, your agent knows every endpoint, authentication method, and best practice — no manual prompting required.
MCP vs Skill: The MCP Server gives your agent direct API access (tool calls). The Skill File gives your agent knowledge about the API (documentation). For the best experience, use both together.

​
Download

Download SKILL.md

Direct download from GitHub

View on GitHub

View source and contribute
Or use curl: 
curl -o SKILL.md https://raw.githubusercontent.com/AiHooked/hooked/main/.cursor/skills/hooked-video-api/SKILL.md

​
Installation

​
Cursor (Project-level)

Place the skill in your project’s .cursor/skills/ directory: 
mkdir -p .cursor/skills/hooked-video-api
curl -o .cursor/skills/hooked-video-api/SKILL.md \
  https://raw.githubusercontent.com/AiHooked/hooked/main/.cursor/skills/hooked-video-api/SKILL.md
Cursor will automatically detect and use the skill when relevant.

​
Cursor (Global)

For all projects, place it in your home directory: 
mkdir -p ~/.cursor/skills/hooked-video-api
curl -o ~/.cursor/skills/hooked-video-api/SKILL.md \
  https://raw.githubusercontent.com/AiHooked/hooked/main/.cursor/skills/hooked-video-api/SKILL.md

​
Claude (via Project Knowledge)

Upload SKILL.md as a project knowledge file in your Claude project settings.

​
What the Skill Teaches

The skill file contains:
SectionWhat the Agent Learns
AuthenticationHow to use x-api-key header
Base URLhttps://api.tryhooked.ai/api/v1
Video CreationAll POST endpoints for script-to-video, prompt-to-video, slideshows, UGC ads
ResourcesGET endpoints for avatars, voices, music
Video StatusHow to check and retrieve videos
TrendsHow to discover trending content
WebhooksHow webhook payloads work
Code ExamplesTypeScript examples for common operations

​
Example Prompts

Once the skill is installed, try these: 
"Create a 30-second UGC ad for my skincare product using avatar Sophia"

"Make a TikTok slideshow about 5 productivity tips with AI-generated images"

"What avatars are available? Show me female avatars for tech content"

"Generate a product demo video from https://mystore.com/product"

"Check the status of video vid_abc123 and download it when ready"

"What's trending on TikTok in the fitness niche? Create a video based on the top trend"

​
Skill + MCP Together

For maximum capability, combine the Skill File with the MCP Server:
  • Skill File gives your agent knowledge (understands the API, knows best practices)
  • MCP Server gives your agent tools (can actually make API calls)
Together, your agent can reason about what video to create AND execute the creation — fully autonomous.

​
Updating

The skill is versioned with the Hooked repository. To update: 
curl -o .cursor/skills/hooked-video-api/SKILL.md \
  https://raw.githubusercontent.com/AiHooked/hooked/main/.cursor/skills/hooked-video-api/SKILL.md

​
Next Steps

MCP Server

Give your agent direct API access with MCP

Quickstart

Create your first video in 5 minutes