> ## Documentation Index
> Fetch the complete documentation index at: https://hyperframes-codex-docs-human-first-refactor.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Install and update agent skills

> Teach a coding agent how to create valid HyperFrames projects and load specialized workflows when needed.

HyperFrames skills teach coding agents the project format, animation rules, media workflow, validation loop, and creation workflows that generic web knowledge does not cover.

## Install for a person

Run the interactive installer:

```bash theme={null}
npx skills add heygen-com/hyperframes --full-depth
```

Select **Core Skills**. The `/hyperframes` router installs a specialized creation workflow when the request needs one, so you do not need the full catalog up front.

Start a fresh agent chat after installation, then ask it to use `/hyperframes`.

## Install or refresh from an agent

For a non-interactive agent or CI environment, use:

```bash theme={null}
npx hyperframes skills update
```

This installs or refreshes the core set and any HyperFrames skills already present in the global install, then links those bundles into compatible installed agents. It does not add every optional workflow.

Check freshness without changing anything:

```bash theme={null}
npx hyperframes skills check
```

Install or refresh one workflow explicitly:

```bash theme={null}
npx hyperframes skills update pr-to-video
```

## Let the router choose

The normal entry point is `/hyperframes`. It confirms the important intent, then selects a workflow from the input:

| You provide                               | Workflow                                                                     |
| ----------------------------------------- | ---------------------------------------------------------------------------- |
| A product website or product brief        | Product launch video                                                         |
| A topic or script with no website capture | Faceless explainer                                                           |
| A GitHub pull request                     | PR-to-video                                                                  |
| Existing talking-head footage             | Captions or a designed recut                                                 |
| A music track                             | Music-driven video                                                           |
| A short design-led animation              | Motion graphic                                                               |
| A presentation                            | Slideshow                                                                    |
| A Figma file or frame                     | Figma import with assets, brand tokens, components, and reconstructed motion |
| Anything outside those shapes             | General video                                                                |

You can invoke a workflow directly when you already know it is the right one, but you do not need to memorize the names to start.

## Install more only when you need it

Install the complete set deliberately with:

```bash theme={null}
npx skills add heygen-com/hyperframes --all --full-depth
```

Or install one named skill:

```bash theme={null}
npx skills add heygen-com/hyperframes --skill hyperframes-animation --full-depth
```

Use the full set for an environment that must work across many HyperFrames tasks without fetching later. For a normal project, the core set is smaller and easier to keep current.

## If the agent cannot see a skill

1. Start a new agent session.
2. Confirm that the project or global skill directory belongs to the agent you are using.
3. Run `npx hyperframes skills check`.
4. Run `npx hyperframes skills update` when the check reports a missing or stale core skill.

The [Quickstart](/quickstart) continues from installation to a first video. The individual skill definitions remain the source of truth for agents and are available in the [HyperFrames repository](https://github.com/heygen-com/hyperframes/tree/main/skills).