Agent skill

JianYing Editor Automation

by luoluoluo22 in luoluoluo22/jianying-editor-skill

Automates JianYing Pro video editing through a Python wrapper, JyWrapper, covering drafts, media import, subtitles, screen recording, voiceover and export.

Apache-2.0Auto-check passedMedia & Creative

SKILL.md written in Chinese; this summary is our English description.

Install JianYing Editor Automation

skills CLI
$ npx skills add luoluoluo22/jianying-editor-skill --skill jianying-editor -a claude-code

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

GitHub CLI
$ gh skill install luoluoluo22/jianying-editor-skill jianying-editor --agent claude-code

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

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

Facts

Skill name
jianying-editor
GitHub stars
3.9k
Token cost
~2.2k tokens
SKILL.md length
444 words
Files
216 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
Apache-2.0

At a glance

Automates JianYing Pro video editing through a Python wrapper, JyWrapper, covering drafts, media import, subtitles, screen recording, voiceover and export.

  • Works in 3 steps: 脚本位置:禁止在 Skill… → 版本与架构 → 配乐选择
  • Automating video edits in JianYing Pro from Python
  • SKILL.md covers 🚨 重要开发原则 (CRITICAL DEVELOPER…, 规则指南 (Rules), 🎯 Agent Quick Routing and 📖 经典示例 (Examples), plus 3 more sections
  • Calls python and git

What it does

The skill wraps JianYing, the Chinese edition of CapCut, in a Python API called JyWrapper, so an agent can generate drafts, import media, add subtitles, text and keyframe animations, apply filters, effects and transitions, record the screen with smart zoom, add TTS voiceover and background music, compose web-based effects and export projects. It works on macOS, on Apple Silicon and Intel, and on Windows, and supports draft_info.json drafts from version 5.9 onward.

Rule files describe the mandatory setup code, core save and export operations, CLI conventions, media import including a 30m/360p profile for AI video analysis, text, keyframes, effects, recording, web VFX, generative editing and audio. A draft inspector script lists drafts and shows summaries. Editing scripts belong in the user's own project, not inside the skill folder, and starting JyProject with overwrite=True can repair a corrupted draft. The SKILL.md mixes Chinese and English.

When your agent uses it

  • Automating video edits in JianYing Pro from Python
  • Generating subtitles or voiceover for a clip in JianYing
  • Recording the screen with automatic zoom and importing it as footage
  • Inspecting or repairing a JianYing draft

Example prompts

  • “Import intro.mp4 into a new JianYing draft and add subtitles.”
  • “Record my screen and apply smart zoom to the clicks, then export the project.”
  • “List my recent JianYing drafts and show a summary of the latest one.”
  • “Add a TTS voiceover and light background music to this draft.”

Requirements

  • JianYing Pro installed
  • Python
  • macOS or Windows

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 脚本位置:禁止在 Skill 内部目录创建剪辑脚本。所有的剪辑逻辑实现代码(.py 脚本)必须存放在用户当前项目的根目录(或子目录,如 scripts/),以保持 Skill 库的纯净和可移植性。
  2. 版本与架构
  3. 配乐选择

What it can do on your machine

Read from SKILL.md and the folder at commit 32c5692. 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/, which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, 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

JianYing Editor Automation loads about 2.2k tokens when it runs, and up to ~31k if it reads all its reference files. Until then it costs about 49 tokens; SKILL.md has 444 words of instructions outside code blocks.

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

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 luoluoluo22/jianying-editor-skill at commit 32c5692, republished under its Apache-2.0 licence (© luoluoluo22). 444 words, ~2,169 tokens.

Download SKILL.mdSave it as .claude/skills/jianying-editor/SKILL.md (or your agent's skills folder). This skill also uses 215 other files; get the full folder from GitHub.
name
jianying-editor
description
剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper),提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows,支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

JianYing Editor Skill

Use this skill when the user wants to automate video editing, generate drafts, or manipulate media assets in JianYing Pro.

Agent execution playbook: docs/agent-playbook.md Minimal command SOP: docs/minimal-command-sop.md Natural language usage guide: usage.md Draft inspector CLI: python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20 python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "DraftName" python <SKILL_ROOT>/scripts/draft_inspector.py show --name "DraftName" --kind content --json For generic editing requests, always follow the "Quick Edit Runtime Template" and "Acceptance Checklist" in that playbook.

🚨 重要开发原则 (CRITICAL DEVELOPER RULES)

  1. 脚本位置:禁止在 Skill 内部目录创建剪辑脚本。所有的剪辑逻辑实现代码(.py 脚本)必须存放在用户当前项目的根目录(或子目录,如 scripts/),以保持 Skill 库的纯净和可移植性。
  2. 版本与架构:
    • 双平台适配:已全面支持 MacOS (路径探测/录屏) 与 Windows。
    • Auto-healing:支持 v5.9+ (draft_info.json)。若草稿损坏或版本冲突,使用 overwrite=True 初始化 JyProject 可触发自动修复。
  3. 配乐选择:
    • 简单演示使用默认音乐。实际项目,应优先检索并推荐 data/cloud_music_library.csv 中的相关曲目,或根据视频主题(如“科技”、“温暖”)进行关键词过滤。
    • 询问用户:“我发现了几首符合主题的云端音乐,要不要试试?(如:Illuminate - 科技感)”。

规则指南 (Rules)

Read the individual rule files for specific tasks and constraints:

🎯 Agent Quick Routing

  • 云端视频 + 云端音乐:rules/media.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py
  • 智能配音与字幕 (Script-to-Video):rules/text.md + rules/audio-voice.md -> 核心 API add_narrated_subtitles
  • 旁白与字幕对齐:rules/text.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py
  • 录屏与智能变焦:rules/recording.md -> tools/recording/recorder.py
  • 批量导出/无头导出:rules/core.md + rules/cli.md -> examples/robust_auto_export.py
  • 影视解说生成:rules/generative.md -> scripts/movie_commentary_builder.py

📖 经典示例 (Examples)

Refer to these for complete workflows:

Show full SKILL.md (247 more words)Show less

🧠 提示词与集成工具 (Prompts & Integrated Tools)

Use these templates and scripts for complex tasks:

  • Asset Search: Find filters, transitions, and animations by Chinese/English name:
    bash
    python <SKILL_ROOT>/scripts/asset_search.py "复古" -c filters
  • Movie Commentary Builder: Generate 60s commentary videos from a storyboard JSON:
    bash
    python <SKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json"
  • Sync Native Assets: Import your favorited/played BGM/Styles from JianYing App to the Skill:
    bash
    python <SKILL_ROOT>/scripts/sync_jy_assets.py
    # Index cloud materials from your existing drafts
    python <SKILL_ROOT>/scripts/build_cloud_music_library.py
    python <SKILL_ROOT>/scripts/build_cloud_text_styles_library.py
  • README to Tutorial: Convert a project's README.md into a full installation tutorial video script:
    • Read prompt: prompts/readme_to_tutorial.md
    • Inject content into {{README_CONTENT}} variable
  • Screen Recorder & Smart Zoom: Record your screen and auto-apply zoom keyframes:
    bash
    python <SKILL_ROOT>/tools/recording/recorder.py
    # Web preview capture (high performance)
    python <SKILL_ROOT>/scripts/web_recorder.py --url "http://localhost:3000" --duration 5
    # Or apply zoom to existing video:
    python <SKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Project" --video "v.mp4" --json "e.json"
  • Draft Inspector: Examine draft structure and metadata (v5.9+ support):
    bash
    python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20
    python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "DraftName"
  • Auto Exporter: Headless export of a draft to MP4/SRT:
    bash
    python <SKILL_ROOT>/scripts/auto_exporter.py "DraftName" "output.mp4" --res 1080 --fps 60
    # For SRT only:
    python <SKILL_ROOT>/scripts/jy_wrapper.py export-srt --name "DraftName"
    Note: MP4 auto export uses Windows UI Automation. On macOS, generate the draft and export it manually from JianYing.
  • Template Clone & Replacer: 安全克隆模板并批量替换物料 (防止损坏原模板):
    bash
    # 克隆模板生成新项目
    python <SKILL_ROOT>/scripts/jy_wrapper.py clone --template "酒店模板" --name "客户A_副本"
  • API Validator: Run a quick diagnostic of your environment:
    bash
    python <SKILL_ROOT>/scripts/api_validator.py

🚀 快速开始示例

python
import os
import sys

# 1. 环境初始化 (必须同步到脚本开头,支持 Win/Mac)
current_dir = os.path.dirname(os.path.abspath(__file__))
env_root = os.getenv("JY_SKILL_ROOT", "").strip()
# 探测 Skill 路径 (支持 Antigravity, Trae, Claude 等)
skill_root = next((p for p in [
    env_root,
    os.path.join(current_dir, ".agents", "skills", "jianying-editor"),
    os.path.join(current_dir, ".agent", "skills", "jianying-editor"),
    os.path.join(current_dir, ".trae", "skills", "jianying-editor"),
    os.path.join(current_dir, ".claude", "skills", "jianying-editor"),
    os.path.join(current_dir, "skills", "jianying-editor"),
    os.path.abspath(".agents/skills/jianying-editor"),
    os.path.abspath(".agent/skills/jianying-editor"),
    os.path.abspath(".trae/skills/jianying-editor"),
    os.path.abspath(".claude/skills/jianying-editor"),
    os.path.abspath("skills/jianying-editor"),
    os.path.dirname(current_dir)
] if p and os.path.exists(os.path.join(p, "scripts", "jy_wrapper.py"))), None)

if not skill_root: raise ImportError("Could not find jianying-editor skill root.")
sys.path.insert(0, os.path.join(skill_root, "scripts"))
from jy_wrapper import JyProject

if __name__ == "__main__":
    # 2. 初始化工程 (支持 v5.9+ 及自修复)
    project = JyProject("New AI Video", overwrite=True)
    assets_dir = os.path.join(skill_root, "assets")

    # 3. 智能配音与字幕 (One-click Script-to-Video)
    project.add_narrated_subtitles(
        text="欢迎使用剪映自动化 Skill。这是一个全面适配 MacOS 的进阶版本。",
        speaker="zh_female_xiaopengyou"
    )

    # 4. 导入额外素材
    project.add_media_safe(os.path.join(assets_dir, "video.mp4"), "0s")
    project.add_media_safe(os.path.join(assets_dir, "audio.mp3"), "0s", track_name="Audio")

    # 5. 添加带动画的标题
    project.add_text_simple("剪映自动化开启", start_time="1s", duration="3s", anim_in="复古打字机")

    project.save()

🛠️ 初始化与项目规范 (Initialization & Project Rules)

在初始化 JyProject 时,请务必根据主视频素材的比例设置分辨率。默认值为横屏 (1920x1080)。

🚨 脚本存放位置规范

禁止在 Skill 安装目录下创建你的业务剪辑脚本。

  • 正确做法:将你的剪辑 Python 脚本放在项目的根目录。
  • 原因:Skill 目录应该只包含工具集源码,便于后续 git pull 升级。业务代码混入会导致版本管理混乱。

© luoluoluo22, Apache-2.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 215 other files (scripts, references, assets) in the repository root of luoluoluo22/jianying-editor-skill.

  • SKILL.md
  • .editorconfig
  • .github/pull_request_template.md
  • .github/workflows/ci.yml
  • .gitignore
  • .pre-commit-config.yaml
  • CHANGELOG.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • SECURITY.md
  • VERSION
  • assets/artistEffect/7127669365423508767/ac476c738e3109c848bfe76f9df8eced/config.json
  • assets/artistEffect/7127669365423508767/ac476c738e3109c848bfe76f9df8eced/content.json
  • assets/artistEffect/7127669365423508767/ac476c738e3109c848bfe76f9df8eced/effect.prefab
  • … and 201 more

Open the folder on GitHubat commit 32c5692

Compare with similar skills

JianYing Editor Automation 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.

JianYing Editor Automation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
JianYing Editor Automation this skillluoluoluo22/jianying-editor-skill3.9k—~2.2kAutomated safety check: PassApache-2.0
Muapi DirectorAnil-matcha/vox-ai-motion-graphics-generator246—~679Automated safety check: PassNone
Remotionzhuzhaoyun/Molio433—~4kAutomated safety check: PassCustom licence
Manim Video Productionbrowser-use/video-use29k6 repos~3kAutomated safety check: PassMIT
MoneyPrinterTurbo Video Generatorharry0703/MoneyPrinterTurbo130k—~2.1kAutomated safety check: WarnMIT
Vox DirectorAlisa0808/vox-director2.2k—~5.6kAutomated safety check: PassMIT

Similar skills

  • Muapi Director

    Anil-matcha/vox-ai-motion-graphics-generator

    Turn ONE topic, talking-head video, or photo into a finished Vox-style paper-collage explainer / ad video on the MuAPI platform (api.muapi.ai) + local ffmpeg — script, collage keyframes, motion…

    246 GitHub stars~679 tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Remotion

    zhuzhaoyun/Molio

    Molio's builtin skill for MAKING a video from any source — wiki notes, articles, scripts, product info, or a brief — and rendering it to MP4.

    433 GitHub stars~4k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Manim Video Production

    browser-use/video-use

    Produces math and technical explainer videos with Manim Community Edition: concept animations, equation derivations, algorithm walkthroughs and data stories.

    29k GitHub starsUsed in 6 repos~3k tokens
    Media & CreativeAuto-check passed
  • MoneyPrinterTurbo Video Generator

    harry0703/MoneyPrinterTurbo

    Installs and runs MoneyPrinterTurbo to turn a topic or script into a finished short video with voice-over, subtitles, stock footage and music.

    130k GitHub stars~2.1k tokensUpdated yesterday
    Media & CreativeAuto-check: warnings
  • Vox Director

    Alisa0808/vox-director

    Turn ONE topic into a finished Vox-style paper-collage explainer / ad video, end to end on the Atlas Cloud API + local ffmpeg — script, collage keyframes, motion, voice-over, music, captions, all…

    2.2k GitHub stars~5.6k tokensUpdated 5 days ago
    Media & CreativeAuto-check passed
  • Mobile Demo Film Editor

    superset-sh/superset

    Edits real mobile screen recordings into a configurable demo video with phone framing, title cards, cutaways and an end card, using a bundled renderer.

    15k GitHub stars~1.8k tokensUpdated today
    Media & CreativeAuto-check passed

Works with

Questions about JianYing Editor Automation

What does JianYing Editor Automation do?

Automates JianYing Pro video editing through a Python wrapper, JyWrapper, covering drafts, media import, subtitles, screen recording, voiceover and export. The skill wraps JianYing, the Chinese edition of CapCut, in a Python API called JyWrapper, so an agent can generate drafts, import media, add subtitles, text and keyframe animations, apply filters, effects and transitions, record the screen with smart zoom, add TTS voiceover and background music, compose web-based effects and export projects.9 onward.

When should I use JianYing Editor Automation?

JianYing Editor Automation fits situations like: automating video edits in JianYing Pro from Python; generating subtitles or voiceover for a clip in JianYing; recording the screen with automatic zoom and importing it as footage; inspecting or repairing a JianYing draft.

How do I install JianYing Editor Automation in Claude Code?

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

How do I install JianYing Editor Automation in Codex?

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

Can I use JianYing Editor Automation 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 luoluoluo22/jianying-editor-skill --skill jianying-editor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/jianying-editor, .gemini/skills/jianying-editor, .github/skills/jianying-editor and .opencode/skills/jianying-editor in your project.

What does JianYing Editor Automation need to run?

Going by SKILL.md and its folder, JianYing Editor Automation needs the command-line tools its instructions call (python and git). Our summary lists: JianYing Pro installed; Python; macOS or Windows.

Does JianYing Editor Automation access the network?

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

Is JianYing Editor Automation 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 JianYing Editor Automation use?

JianYing Editor Automation is published under the Apache-2.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does JianYing Editor Automation use?

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

What are the alternatives to JianYing Editor Automation?

Skills that share tags, products or a category with JianYing Editor Automation: Muapi Director (Anil-matcha/vox-ai-motion-graphics-generator, 246 stars), Remotion (zhuzhaoyun/Molio, 433 stars), Manim Video Production (browser-use/video-use, 29k stars) and MoneyPrinterTurbo Video Generator (harry0703/MoneyPrinterTurbo, 130k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains JianYing Editor Automation?

luoluoluo22 (a GitHub user) maintains it in luoluoluo22/jianying-editor-skill, which has 3,867 GitHub stars. The repository was last updated on September 11, 2026.

Source: luoluoluo22/jianying-editor-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.