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

# Skill File

> Teach your AI agent to create videos with the Hooked skill

## 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.

<Info>
  **MCP vs Skill**: The [MCP Server](/guides/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.
</Info>

## Download

<CardGroup cols={2}>
  <Card title="Download SKILL.md" icon="download" href="https://raw.githubusercontent.com/hooked-so/hooked-skill/main/SKILL.md">
    Direct download from GitHub
  </Card>

  <Card title="View on GitHub" icon="github" href="https://github.com/hooked-so/hooked-skill/tree/main">
    View source and contribute
  </Card>
</CardGroup>

Or use curl:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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](/guides/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:

```bash theme={null}
curl -o .cursor/skills/hooked-video-api/SKILL.md \
  https://raw.githubusercontent.com/hooked-so/hooked-skill/main/SKILL.md
```

## Next Steps

<CardGroup cols={2}>
  <Card title="MCP Server" icon="robot" href="/guides/mcp-server">
    Give your agent direct API access with MCP
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Create your first video in 5 minutes
  </Card>
</CardGroup>