Agent skill

Flyworks Avatar Video

by freestylefly in freestylefly/canghe-skills

Generate videos using Flyworks (a.k.a HiFly) Digital Humans.

MITAuto-check passedMedia & Creative

Install Flyworks Avatar Video

skills CLI
$ npx skills add freestylefly/canghe-skills --skill flyworks-avatar-video -a claude-code

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

GitHub CLI
$ gh skill install freestylefly/canghe-skills flyworks-avatar-video --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/freestylefly/canghe-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/flyworks-avatar-video-1.0.0 .claude/skills/flyworks-avatar-video && 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
flyworks-avatar-video
GitHub stars
461
Token cost
~1.3k tokens
SKILL.md length
371 words
Files
9 (incl. scripts, references)
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Generate videos using Flyworks (a.k.a HiFly) Digital Humans.

  • Works in 2 steps: Create a simple greeting video → Use a custom talking photo
  • Tasks that involve AI video generation
  • SKILL.md covers API Token & Limitations, Tools, Examples and Agent Behavior Guidelines
  • Runs Python scripts from its folder; calls python; needs HIFLY_API_TOKEN

What it does

Flyworks Avatar Video is an agent skill from freestylefly/canghe-skills. Generate videos using Flyworks (a.k.a HiFly) Digital Humans. Create talking photo videos from images, use public avatars with TTS, or clone voices for custom audio.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts and reference files (for example `README.md`, `_meta.json` and `references/authentication.md`). Compatibility notes: Requires Python 3 and network access to hfw-api.hifly.cc

It sits in Media & Creative, covering AI video generation and Text to speech and voice. The repository describes itself as: 苍何的技能skills仓库,搜集好用的 skills,辅助提效. The licence is MIT.

When your agent uses it

  • Tasks that involve AI video generation
  • Tasks that involve Text to speech and voice

Example prompts

  • “/flyworks-avatar-video”

Requirements

  • Python 3
  • A credential in HIFLY_API_TOKEN
  • Compatibility (from SKILL.md): Requires Python 3 and network access to hfw-api.hifly.cc

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Create a simple greeting video
  2. Use a custom talking photo

What it can do on your machine

Read from SKILL.md and the folder at commit dd0bf35. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

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

  • Network

    Links to these hosts (documentation or services it may open):

    • hifly.cc
    • flyworks.ai

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • HIFLY_API_TOKEN

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

  • Compatibility

    Requires Python 3 and network access to hfw-api.hifly.cc

    From compatibility in the SKILL.md frontmatter.

Context cost

Flyworks Avatar Video loads about 1.3k tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 47 tokens; SKILL.md has 371 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.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); the scripts in this folder are not scanned.

SKILL.md

The full file from freestylefly/canghe-skills at commit dd0bf35, republished under its MIT licence (© freestylefly). 371 words, ~1,297 tokens.

Download SKILL.mdSave it as .claude/skills/flyworks-avatar-video/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
flyworks-avatar-video
description
Generate videos using Flyworks (a.k.a HiFly) Digital Humans. Create talking photo videos from images, use public avatars with TTS, or clone voices for custom audio.
compatibility
Requires Python 3 and network access to hfw-api.hifly.cc
license
MIT

Avatar Video Generation Skill

This skill allows you to generate videos using Flyworks (a.k.a HiFly 飞影数字人) Digital Humans. Available features:

  1. Public Avatar Video: Create video from text or audio using pre-made highly realistic avatars.
  2. Talking Photo: Create a "talking photo" video from a single image and text/audio.
  3. Voice Cloning: Clone a voice from an audio sample to use in TTS.

For detailed documentation, see the references/ folder:

API Token & Limitations

This skill works with a default free-tier token, but it has limitations:

  • Watermark: Generated videos will have a watermark.
  • Duration Limit: Videos are limited to 30 seconds.

To remove limitations:

  1. Register at hifly.cc or flyworks.ai.
  2. Get your API key from User Settings.
  3. Set the environment variable: export HIFLY_API_TOKEN="your_token_here"

Tools

scripts/hifly_client.py

The main entry point for all operations.

Usage
bash
# List available public avatars
python scripts/hifly_client.py list_public_avatars

# List available public voices
python scripts/hifly_client.py list_public_voices

# Create a video with a public avatar (TTS)
python scripts/hifly_client.py create_video --type tts --text "Hello world" --avatar "avatar_id_or_alias" --voice "voice_id_or_alias"

# Create a video with a public avatar (Audio URL or File)
python scripts/hifly_client.py create_video --audio "https://... or path/to/audio.mp3" --avatar "avatar_id_or_alias"

# Create a talked photo video using bundled assets
python scripts/hifly_client.py create_talking_photo --image assets/avatar.png --title "Bundled Avatar"

# Clone a voice using bundled assets
python scripts/hifly_client.py clone_voice --audio assets/voice.MP3 --title "Bundled Voice"

# Check status of generated tasks
python scripts/hifly_client.py check_task --id "TASK_ID"

# Manage local aliases (saved in memory.json)
python scripts/hifly_client.py manage_memory add my_avatar "av_12345"
python scripts/hifly_client.py manage_memory list

Examples

1. Create a simple greeting video
bash
# First find a voice and avatar
python scripts/hifly_client.py list_public_avatars
python scripts/hifly_client.py list_public_voices

# Generate
python scripts/hifly_client.py create_video --type tts --text "Welcome to our service." --avatar "av_public_01" --voice "voice_public_01"
2. Use a custom talking photo
bash
# Create the avatar from an image URL
python scripts/hifly_client.py create_talking_photo --image "https://mysite.com/photo.jpg" --title "CEO Photo"
# Output will give you an Avatar ID, e.g., av_custom_99

# Save it to memory
python scripts/hifly_client.py manage_memory add ceo av_custom_99

# Generate video using the new avatar
python scripts/hifly_client.py create_video --type tts --text "Here is the quarterly report." --avatar ceo --voice "voice_public_01"

Agent Behavior Guidelines

When assisting users with video generation, follow these guidelines:

Show full SKILL.md (213 more words)Show less
Voice Selection Required

Video generation requires both text AND a voice. If the user provides text but no voice:

  1. Check local memory first: Run manage_memory list to see if the user has saved any voice aliases.

  2. Ask the user to choose:

    • "I see you want to create a video with the text '[text]'. Which voice would you like to use?"
    • If they have saved voices: "You have these saved voices: [list]. Or would you prefer a public voice?"
    • If no saved voices: "Would you like to use a public voice, or clone your own voice from an audio sample first?"
  3. Help them select:

    • To see public voices: list_public_voices
    • To clone a voice: clone_voice --audio [file] --title [name]
Complete Workflow Example

For a prompt like "Create a talking photo video from my photo saying 'this is my AI twin'":

  1. Ask: "Which voice would you like for your AI twin? You can use a public voice or clone your own."
  2. If they want to clone: Help them with clone_voice
  3. Create the talking photo with both text and voice:
    bash
    python scripts/hifly_client.py create_talking_photo \
      --image user_photo.jpg \
      --text "this is my AI twin" \
      --voice SELECTED_VOICE_ID \
      --title "My AI Twin"
Saving for Later

After creating avatars or cloning voices, offer to save them:

bash
python scripts/hifly_client.py manage_memory add my_avatar AVATAR_ID --kind avatar
python scripts/hifly_client.py manage_memory add my_voice VOICE_ID --kind voice

© freestylefly, MIT. 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 8 other files (scripts, references) in skills/flyworks-avatar-video-1.0.0 of freestylefly/canghe-skills.

  • SKILL.md
  • README.md
  • _meta.json
  • references/authentication.md
  • references/avatars.md
  • references/video-generation.md
  • references/voices.md
  • requirements.txt
  • scripts/hifly_client.py

Open the folder on GitHubat commit dd0bf35

Compare with similar skills

Flyworks Avatar Video 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.

Flyworks Avatar Video compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flyworks Avatar Video this skillfreestylefly/canghe-skills461—~1.3kAutomated safety check: PassMIT
Narrator AI CLINarratorAI-Studio/narrator-ai-cli-skill3k—~4.5kAutomated safety check: PassMIT
Ergo Remotion Videoitwanger/toBeBetterJavaer18k—~1.1kAutomated safety check: PassNone
Wedding Video Guided Wizardaaronyi97/wedding-video-guided-wizard310—~1kAutomated safety check: PassMIT
RunninghubHM-RunningHub/OpenClaw_RH_Skills142—~1.6kAutomated safety check: PassApache-2.0
AI Video Production Assistantwanghui2323/ai-video-maker101—~924Automated safety check: PassMIT

Similar skills

  • Narrator AI CLI

    NarratorAI-Studio/narrator-ai-cli-skill

    AI 电影/短剧解说视频自动生成(AI 解说大师 CLI Skill)。当用户需要创建电影解说视频、短剧解说、影视二创、AI 配音旁白视频、film commentary、video narration、drama dubbing、movie narration 时触发。内置电影素材库、BGM、多语种配音、解说模板。通过 narrator-ai-cli 命令行实现:搜片→选模板→选…

    3k GitHub stars~4.5k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Ergo Remotion Video

    itwanger/toBeBetterJavaer

    把口播稿做成二哥风格的 Remotion 视频,包括整理视频用稿、火山 TTS 配音、音画对齐、逐章动画预览和导出带配音的 MP4。用户说“做视频”“口播稿转视频”“Remotion”“继续做下一章”“出片”“渲染”“改读音”“配音读错了”,或给出 docs/src/ai/video/ 下的稿子要做成视频时使用。共享工具、配置和素材在…

    18k GitHub stars~1.1k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Wedding Video Guided Wizard

    aaronyi97/wedding-video-guided-wizard

    Guide a creator through a real couple's custom wedding video, from a shareable story intake card and Kimi writing pack through narration, external GPT image prompts, image-to-video packs, music and…

    310 GitHub stars~1k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Runninghub

    HM-RunningHub/OpenClaw_RH_Skills

    Generate images, videos, audio, and 3D models via RunningHub API (420 endpoints) and run any RunningHub AI Application (custom ComfyUI workflow) by webappId.

    142 GitHub stars~1.6k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • AI Video Production Assistant

    wanghui2323/ai-video-maker

    Turns an idea, article, outline or audio file into a sourced, reviewable AI video, tracking whether narration uses a human, synthetic or cloned voice.

    101 GitHub stars~924 tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Media Gen

    clacky-ai/openclacky

    Generate or edit images, videos, or audio in the current task.

    1.2k GitHub stars~7.5k tokensUpdated today
    Media & CreativeAuto-check passed

More from freestylefly/canghe-skills

All 19 skills in this repo
  • Canghe Comic

    freestylefly/canghe-skills

    Knowledge comic creator supporting multiple art styles and tones.

    461 GitHub starsUsed in 8 repos~3.2k tokens
    Auto-check passed
  • Canghe Post To Wechat

    freestylefly/canghe-skills

    Posts content to WeChat Official Account (微信公众号) via API or Chrome CDP.

    461 GitHub starsUsed in 3 repos~3.4k tokens
    Auto-check: notes
  • Canghe Post To X

    freestylefly/canghe-skills

    Posts content and articles to X (Twitter). An agent skill from freestylefly/canghe-skills.

    461 GitHub starsUsed in 4 repos~1.7k tokens
    Auto-check: warnings
  • Canghe URL To Markdown

    freestylefly/canghe-skills

    Fetch any URL and convert to markdown using Chrome CDP. An agent skill from freestylefly/canghe-skills.

    461 GitHub starsUsed in 4 repos~1.1k tokens
    Auto-check passed
  • Canghe Xhs Images

    freestylefly/canghe-skills

    Generates Xiaohongshu (Little Red Book) infographic series with 10 visual styles and 8 layouts.

    461 GitHub starsUsed in 4 repos~4.9k tokens
    Auto-check passed
  • Canghe Markdown To HTML

    freestylefly/canghe-skills

    Converts Markdown to styled HTML with WeChat-compatible themes.

    461 GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check passed

Questions about Flyworks Avatar Video

What does Flyworks Avatar Video do?

Generate videos using Flyworks (a.k.a HiFly) Digital Humans. Flyworks Avatar Video is an agent skill from freestylefly/canghe-skills.a HiFly) Digital Humans.

When should I use Flyworks Avatar Video?

Flyworks Avatar Video fits situations like: tasks that involve AI video generation; tasks that involve Text to speech and voice.

How do I install Flyworks Avatar Video in Claude Code?

Run `npx skills add freestylefly/canghe-skills --skill flyworks-avatar-video -a claude-code`. Or copy the skill folder (skills/flyworks-avatar-video-1.0.0 in freestylefly/canghe-skills) into .claude/skills/flyworks-avatar-video in your project. Claude Code loads it when a task matches its description.

How do I install Flyworks Avatar Video in Codex?

Run `npx skills add freestylefly/canghe-skills --skill flyworks-avatar-video -a codex`. Or copy the skill folder (skills/flyworks-avatar-video-1.0.0 in freestylefly/canghe-skills) into .agents/skills/flyworks-avatar-video in your project. Codex loads it when a task matches its description.

Can I use Flyworks Avatar Video 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 freestylefly/canghe-skills --skill flyworks-avatar-video -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flyworks-avatar-video, .gemini/skills/flyworks-avatar-video, .github/skills/flyworks-avatar-video and .opencode/skills/flyworks-avatar-video in your project.

What does Flyworks Avatar Video need to run?

Going by SKILL.md and its folder, Flyworks Avatar Video needs Python for the scripts in its folder, the command-line tools its instructions call (python) and credentials named HIFLY_API_TOKEN. Our summary lists: Python 3; A credential in HIFLY_API_TOKEN. Compatibility (from SKILL.md): Requires Python 3 and network access to hfw-api.hifly.cc.

Does Flyworks Avatar Video access the network?

SKILL.md names 2 domains. As links in the text: hifly.cc and flyworks.ai. This is read from the text; nothing was executed.

Is Flyworks Avatar Video 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Flyworks Avatar Video use?

Flyworks Avatar Video is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flyworks Avatar Video use?

About 1.3k tokens (SKILL.md is roughly 5.2k 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 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Flyworks Avatar Video?

Skills that share tags, products or a category with Flyworks Avatar Video: Narrator AI CLI (NarratorAI-Studio/narrator-ai-cli-skill, 3k stars), Ergo Remotion Video (itwanger/toBeBetterJavaer, 18k stars), Wedding Video Guided Wizard (aaronyi97/wedding-video-guided-wizard, 310 stars) and Runninghub (HM-RunningHub/OpenClaw_RH_Skills, 142 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flyworks Avatar Video?

freestylefly (a GitHub user) maintains it in freestylefly/canghe-skills, which has 461 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on June 8, 2026.

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