luoluoluo22/jianying-editor-skill

Overview

This skill wraps JianYing (CapCut Chinese edition) editing capabilities into an easy-to-use Python API (JyWrapper). It automates common video editing tasks such as importing assets, screen recording, subtitle generation, web-based visual effects, and headless project export. The goal is repeatable, scriptable video production pipelines for drafts and final exports.

How this skill works

The skill exposes a JyProject class and command-line scripts that perform initialization, asset import, timeline operations, text/subtitle creation, keyframe animations, effect application, and export. Scripts follow mandatory setup rules to locate the skill root and then call high-level methods like add_media_safe, add_text_simple, apply-zoom, and auto_exporter to build and export projects. Advanced scripts chain transcribe->match->assemble or generate web-to-video VFX automatically.

When to use it

• Automating repeatable content creation such as vlogs, tutorials, or social clips.
• Batch-processing many source clips into consistent drafts or final exports.
• Generating subtitles (SRT) and voiceovers programmatically.
• Applying screen recording + smart zoom or other motion keyframes automatically.
• Creating web-driven visual effects or AI-driven B-roll matching workflows.

Best practices

• Always run the mandatory environment initialization at the top of scripts to locate the skill root and scripts folder.
• Use add_media_safe to import assets to avoid duplicate imports and preserve timestamps.
• Keep templates read-only: clone templates before making bulk replacements to avoid corrupting originals.
• Validate the environment with the provided api_validator script before heavy batch runs.
• Use auto_exporter for headless exports and separate SRT export when only subtitles are needed.

Example use cases

• Create a 60s commentary video by converting a README or storyboard JSON into timeline clips with background music.
• Transcribe a raw interview, semantically match B-roll by AI, and assemble a draft project automatically.
• Record a software demo screen, auto-apply smart zoom keyframes, and export a social-ready clip.
• Batch-clone a hotel promo template, replace assets per client, and export personalized drafts.
• Run nightly exports of a queue of drafts to MP4 at specified resolution and FPS.