Skill File

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/hooked-so/hooked-skill/main/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/hooked-so/hooked-skill/main/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/hooked-so/hooked-skill/main/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:

Section	What the Agent Learns
Authentication	How to use `x-api-key` header
Base URL	`https://api.hooked.so/v1`
Video Creation	All POST endpoints for script-to-video, prompt-to-video, slideshows, UGC ads
Resources	GET endpoints for avatars, voices, music
Video Status	How to check and retrieve videos
Trends	How to discover trending content
Webhooks	How webhook payloads work
Code Examples	TypeScript 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/hooked-so/hooked-skill/main/SKILL.md

Getting Started

Core Concepts

AI Agents

Guides

Examples

Overview

Download

Download SKILL.md

View on GitHub

Installation

Cursor (Project-level)

Cursor (Global)

Claude (via Project Knowledge)

What the Skill Teaches

Example Prompts

Skill + MCP Together

Updating

Next Steps

MCP Server

Quickstart

​Overview

​Download

Download SKILL.md

View on GitHub

​Installation

​Cursor (Project-level)

​Cursor (Global)

​Claude (via Project Knowledge)

​What the Skill Teaches

​Example Prompts

​Skill + MCP Together

​Updating

​Next Steps

MCP Server

Quickstart

Overview

Download

Installation

Cursor (Project-level)

Cursor (Global)

Claude (via Project Knowledge)

What the Skill Teaches

Example Prompts

Skill + MCP Together

Updating

Next Steps