Agent skill

Ui2v

by illli-studio in illli-studio/ui2v

A skill your agent uses when helping users discover, install, publish, share, sync, or update UI2V video motion assets and HyperFrames motion packages.

GPL-3.0Auto-check passedMedia & Creative

Install Ui2v

skills CLI
$ npx skills add illli-studio/ui2v --skill ui2v -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install illli-studio/ui2v ui2v --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/illli-studio/ui2v.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ui2v .claude/skills/ui2v && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ui2v
GitHub stars
105
Used in
1 other repo
Token cost
~1.5k tokens
SKILL.md length
533 words
Files
6 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
GPL-3.0

At a glance

A skill your agent uses when helping users discover, install, publish, share, sync, or update UI2V video motion assets and HyperFrames motion packages.

  • Helping users discover
  • SKILL.md covers Mental model, Task routing, CLI version gate and Monorepo development workflow, plus 6 more sections
  • Calls bun, npm and node
  • Update UI2V video motion assets and HyperFrames motion packages

What it does

Ui2v is an agent skill from illli-studio/ui2v. Use when helping users discover, install, publish, share, sync, or update UI2V video motion assets and HyperFrames motion packages. Route video creation, preview, and rendering to HyperFrames skills.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `references/cleanup.md`, `references/package-format.md` and `references/positioning.md`).

It sits in Media & Creative, covering Motion graphics. It works with HeyGen and npm. The repository describes itself as: Ui2v is a local AI motion designer. It's fast, private, and fully under your control. The licence is GPL-3.0.

When your agent uses it

  • Helping users discover
  • Update UI2V video motion assets and HyperFrames motion packages

Example prompts

  • “/ui2v”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 7c1ab79. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bun
    • npm
    • node
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ui2v loads about 1.5k tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 51 tokens; SKILL.md has 533 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from illli-studio/ui2v at commit 7c1ab79, republished under its GPL-3.0 licence (© illli-studio). 533 words, ~1,456 tokens.

Download SKILL.mdSave it as .claude/skills/ui2v/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
ui2v
description
Use when helping users discover, install, publish, share, sync, or update UI2V video motion assets and HyperFrames motion packages. Route video creation, preview, and rendering to HyperFrames skills.
version
2.1.0
display_name
UI2V视频动效资源库
display_name_en
UI2V Video Motion Asset Library
description_zh
让 AI 帮你发现、安装和分享 UI2V 视频动效资源。支持 HyperFrames 动效包的搜索、安装、发布、同步与更新,让已有动效轻松复用,也让原创作品更容易被发现。
description_en
Let AI help you discover, install, and share UI2V video motion assets. Search, install, publish, sync, and update HyperFrames motion packages so existing…
metadata.short-description
AI 驱动的 UI2V 视频动效资源库

ui2v Skill

UI2V 是面向 AI 工作流的 视频动效资源库。它帮助用户发现、安装、复用和分享 HyperFrames 动效包;实际的视频创作、预览和渲染由 HyperFrames 完成。

For project positioning, README copy, npm copy, website copy, or launch/promo text, read references/positioning.md.

Mental model

text
HyperFrames authoring -> package folder -> ui2v login -> ui2v motion publish -> ui2v.com
LayerTool
Author / preview / renderHyperFrames (/hyperframes and related skills)
Search / install / publish / syncui2v CLI (npm package @ui2v/cli, bin ui2v)

Do not use the abandoned @ui2v/cli@1.x JSON render/preview stack (doctor, validate, preview, render, animation.json, @ui2v/core, @ui2v/engine, @ui2v/producer). The current @ui2v/cli package is the registry client.

Task routing

Use this skill for registry work and CLI/package maintenance:

  • Publish/share/install/search a motion on ui2v.com → use this skill and the ui2v CLI.
  • Fix or extend the UI2V CLI → inspect packages/ui2v/src/cli, update focused tests, then run the repo verification commands below.
  • Fix registry package metadata or a publish failure → read references/package-format.md and references/publish.md.
  • Update website, README, npm, or promo copy → read references/positioning.md; keep package references as npm @ui2v/cli, bin command ui2v, and npx command npx @ui2v/cli@latest ....
  • Clean project structure → read references/cleanup.md; remove or route away from legacy JSON renderer examples/scripts; do not present them as current UI2V capabilities.
  • Prepare or explain a release → read references/release.md; verify versions, tests, build, and npm copy.

Route away from this skill when the user is not doing registry work:

  • Make / edit / preview / render a video composition → use HyperFrames skills, not this CLI.
  • Old JSON ui2v projects → do not revive the old JSON toolchain. Migrate to a HyperFrames package, then publish with ui2v.

CLI version gate

Before publish/install/sync that depends on current CLI behavior:

bash
ui2v --cli-version
npm view @ui2v/cli version
  • Missing CLI → install: npm install -g @ui2v/cli@latest (or bun install -g @ui2v/cli)
  • Behind latest → ui2v upgrade (alias self-update), or npm install -g @ui2v/cli@latest
  • Under --no-input, ui2v upgrade only prints the install command and exits non-zero when outdated

npm view is metadata only. Do not upgrade as a routine first step unless the CLI is missing, too old for the task, broken, or the user asks for latest.

From this monorepo before publishing:

bash
cd packages/ui2v && bun run build && node bin/ui2v.js --cli-version
Show full SKILL.md (219 more words)Show less

Monorepo development workflow

For CLI source changes in this repository:

bash
bun install
bun run build
bun run test
bun run --filter "@ui2v/cli" verify
node packages/ui2v/bin/ui2v.js --help
node packages/ui2v/bin/ui2v.js --cli-version

Prefer the narrowest useful test first while iterating:

bash
cd packages/ui2v
bun run test:src
bun run verify:build
bun run test:artifact

Package shape

A motion folder must include:

  • registry-item.json with type: "hyperframes:block"
  • Entry composition HTML (index.html or listed composition file)
  • Optional assets/, README.md, thumbnail

Details: references/package-format.md.

Positioning

When introducing the project, use this core message:

text
让 AI 帮你发现、安装和分享 UI2V 视频动效资源:
搜索并安装现成动效,发布原创作品,让动画像依赖一样轻松复用。

Do not call UI2V a renderer. Keep the boundary crisp:

  • HyperFrames creates, previews, and renders motion.
  • UI2V distributes completed motion packages through search, install, publish, sync, and inspect workflows.

Publish flow

bash
ui2v login
ui2v motion publish ./my-motion --version 1.0.0
# optional: ui2v sync

Aliases: ui2v skill publish, legacy ui2v publish.

Full checklist: references/publish.md.

Release flow

For npm release preparation, use references/release.md. Do not publish or bump versions casually; first confirm the requested version and run local verification.

Common registry commands

bash
ui2v search "logo sting"
ui2v install <slug>
ui2v list
ui2v update --all
ui2v explore
ui2v inspect <slug>
ui2v upgrade

Install command shown on the site: npx @ui2v/cli@latest install <slug>.

Troubleshooting cookbook

  • CLI not found → install @ui2v/cli, then confirm ui2v --cli-version.
  • Outdated CLI → run ui2v upgrade or npm install -g @ui2v/cli@latest.
  • Auth failure → run ui2v login; for automation use ui2v login --token clh_... only when the user provides a token.
  • Publish rejects version → ensure --version is valid semver and is newer than the published release.
  • Missing entry HTML → check index.html, first files[] composition path, or {name}.html.
  • Manifest validation failure → check type: "hyperframes:block", dimensions, duration, and files[] using references/package-format.md.
  • Render/preview request appears → stop using UI2V commands and route to HyperFrames.

© illli-studio, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in skills/ui2v of illli-studio/ui2v.

  • SKILL.md
  • references/cleanup.md
  • references/package-format.md
  • references/positioning.md
  • references/publish.md
  • references/release.md

Open the folder on GitHubat commit 7c1ab79

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in illli-studio/ui2v, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Ui2v next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ui2v compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ui2v this skillillli-studio/ui2v1051 repos~1.5kAutomated safety check: PassGPL-3.0
Create VideoCuongyd196/auto-compare-video210—~2.8kAutomated safety check: NotesCustom licence
Talking Head HyperframesbozhouDev/video-skills-toolkit150—~927Automated safety check: PassMIT
Session Story Filmheygen-com/hyperframes-community-skills178—~1.8kAutomated safety check: PassApache-2.0
Remotion to HyperFrames Porterheygen-com/hyperframes59k3 repos~2.8kAutomated safety check: PassApache-2.0
Hyperframes CLInateherkai/hyperframes-student-kit1.2k3 repos~1.2kAutomated safety check: PassCustom licence

Similar skills

  • Create Video

    Cuongyd196/auto-compare-video

    Tạo một video MỚI cho series "so sánh / phân biệt kiến thức" của repo này — clip dọc TikTok/Reels/Shorts 30-40s, layout 3-zone cố định theo DESIGN.md, voiceover tiếng Việt sinh bằng VieNeu TTS…

    210 GitHub stars~2.8k tokensUpdated 14 days ago
    Media & CreativeAuto-check: notes
  • Talking Head Hyperframes

    bozhouDev/video-skills-toolkit

    为 HyperFrames 口播或旁白项目创建、修复并验证固定舞台,锁定数字人 PIP 的区域、裁切、人物安全区和不透明背景,归档输入,生成 manifest 与 template handoff,并在就绪后按“字幕驱动的全镜头静态审核→动效”门禁路由到 hyperframes-scene-animator。适用于“新建 HyperFrames…

    150 GitHub stars~927 tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Session Story Film

    heygen-com/hyperframes-community-skills

    Turns one typical session between you and your agent into a short animated film built from your real messages, with a composed score, after you approve every line.

    178 GitHub stars~1.8k tokensUpdated 9 days ago
    Media & CreativeAuto-check passed
  • Remotion to HyperFrames Porter

    heygen-com/hyperframes

    Ports an existing Remotion (React) composition to HyperFrames HTML with GSAP, one way, and grades the result against a tiered set of reference fixtures.

    59k GitHub starsUsed in 3 repos~2.8k tokens
    Media & CreativeAuto-check passed
  • Hyperframes CLI

    nateherkai/hyperframes-student-kit

    HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark.

    1.2k GitHub starsUsed in 3 repos~1.2k tokens
    Media & CreativeAuto-check passed
  • Hyperframes CLI

    coleam00/hyperframes-ai-video-generation

    HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark.

    148 GitHub stars~1.6k tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed

Works with

Questions about Ui2v

What does Ui2v do?

A skill your agent uses when helping users discover, install, publish, share, sync, or update UI2V video motion assets and HyperFrames motion packages. Ui2v is an agent skill from illli-studio/ui2v. Use when helping users discover, install, publish, share, sync, or update UI2V video motion assets and HyperFrames motion packages.

When should I use Ui2v?

Ui2v fits situations like: helping users discover; update UI2V video motion assets and HyperFrames motion packages.

How do I install Ui2v in Claude Code?

Run `npx skills add illli-studio/ui2v --skill ui2v -a claude-code`. Or copy the skill folder (skills/ui2v in illli-studio/ui2v) into .claude/skills/ui2v in your project. Claude Code loads it when a task matches its description.

How do I install Ui2v in Codex?

Run `npx skills add illli-studio/ui2v --skill ui2v -a codex`. Or copy the skill folder (skills/ui2v in illli-studio/ui2v) into .agents/skills/ui2v in your project. Codex loads it when a task matches its description.

Can I use Ui2v in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add illli-studio/ui2v --skill ui2v -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ui2v, .gemini/skills/ui2v, .github/skills/ui2v and .opencode/skills/ui2v in your project.

What does Ui2v need to run?

Going by SKILL.md and its folder, Ui2v needs the command-line tools its instructions call (bun, npm, node and npx). Our summary lists: Node.js.

Does Ui2v access the network?

SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ui2v safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ui2v use?

Ui2v is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ui2v use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Ui2v?

Skills that share tags, products or a category with Ui2v: Create Video (Cuongyd196/auto-compare-video, 210 stars), Talking Head Hyperframes (bozhouDev/video-skills-toolkit, 150 stars), Session Story Film (heygen-com/hyperframes-community-skills, 178 stars) and Remotion to HyperFrames Porter (heygen-com/hyperframes, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ui2v?

illli-studio (a GitHub organization) maintains it in illli-studio/ui2v, which has 105 GitHub stars. The repository was last updated on September 16, 2026.

Source: illli-studio/ui2v on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.