Communitygithub.com

2789927464king-jpg/video-skill-ku

Ajoute des incrustations visuelles à des enregistrements d'écran déjà montés : superpose des calques HTML (annotations, animations plein écran, zooms) synchronisés sur les sous-titres, pilotés image par image par le lecteur, avec aperçu en direct. Utilisez-le pour créer des storyboards, ajouter des animations, des B-roll, ou annoter des points clés. Ne pas l'utiliser pour couper du contenu, ajouter des sous-titres, faire des montages physiques, ou exporter la vidéo finale.

Qu'est-ce que video-skill-ku ?

Ce skill permet de superposer dynamiquement des calques HTML sur des enregistrements d'écran déjà montés, en les synchronisant précisément avec les sous-titres. Il est conçu pour des tâches de post-production où l'utilisateur souhaite ajouter des annotations, des animations plein écran, des zooms, ou des B-roll sans altérer la vidéo source. Le skill ne modifie pas le montage vidéo lui-même ; il crée des calques visuels qui sont pilotés image par image par le lecteur, offrant un aperçu en temps réel. Il s'appuie sur trois fichiers d'entrée (édition, transcription, sous-titres) et génère un fichier de configuration visuelle ainsi que des modules HTML. Le flux de travail est strict : analyse sémantique des sous-titres, extraction d'images clés pour évaluer le contenu visuel, mesure des fenêtres de mouvement pour éviter les chevauchements, puis création et placement des calques. Une règle importante est de ne jamais sauter les étapes d'extraction d'images et de mesure de mouvement, sous peine d'erreurs. Le skill est conçu pour être utilisé avec l'outil de CLI fourni, dans un environnement de bureau géré, et inclut des vérifications d'intégrité et de compatibilité.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/chengfeng-videocut-skills/plugins/chengfeng-videocut/skills/chengfeng-visual

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Incrustation (Storyboard)

C'est une tâche unique, pas une étape d'un processus. On l'exécute quand l'utilisateur le demande, et on peut y revenir après avoir modifié le montage.

Il n'y a que deux prérequis : le journal et les sous-titres doivent déjà exister (les calques sont attachés aux blocs de sous-titres, la durée est calculée à partir du journal).

Nécessite   edit-list.json, transcript.json, subtitles.json
Produit     visuals.json + modules/<numéro-nom>/index.html

Une fois terminé, on s'arrête, on ne dirige pas l'utilisateur vers l'étape suivante.

Lisez et exécutez d'abord le contrat de flux de travail métier. Les règles strictes pour l'écriture des modules se trouvent dans le contrat de module, et les règles de jugement dans le jugement visuel.

0. Préparation

Exécutez d'abord la « vérification de préparation » de Vérifier les mises à jour — vérifier si les skills sont à jour, si le Runtime est compatible ; la racine du plugin est également localisée ici (dans les commandes de ce document, <racinePlugin> est remplacé par ce chemin littéral). Continuez seulement si le résultat est « prêt » ; si le résultat est « nécessite une nouvelle session » ou « stop », suivez ses instructions (y compris l'interdiction de « créer une interface alternative maison »). Le skill métier n'intègre pas de logique d'environnement.

Si le résultat de la préparation est runtime.kind=desktop-managed, réutilisez directement la CLI stable déjà installée par l'application de bureau et le même service launchd/windows-task ; ne résolvez pas le chemin Electron, n'installez pas de dépendances supplémentaires, et ne démarrez pas un second Runtime.

Commandes

node "<racinePlugin>/scripts/ensure-running.cjs" --json
node "<racinePlugin>/scripts/videocut-cli.cjs" visual get   <projet> --json
node "<racinePlugin>/scripts/videocut-cli.cjs" visual frame <projet> --cues sub-0004,sub-0005 --count 12 --out <dossier> --json
node "<racinePlugin>/scripts/videocut-cli.cjs" visual add   <projet> --module modules/01-xx/index.html --cues sub-0004,sub-0005 [--zoom x,y,w,h] [--id vis-0001] --json
node "<racinePlugin>/scripts/videocut-cli.cjs" visual remove <projet> --id vis-0001 --json

ensure-running doit d'abord prouver que le port canonique 5190 appartient au service géré de la plateforme actuelle ; en cas d'échec, transmettez l'erreur et arrêtez-vous, ne revenez pas en avant-plan ou sur un port choisi.

Les calques sont liés aux blocs de sous-titres (--cues), le produit convertit lui-même en identifiants de mots — un calque ne peut jamais être attaché à des mots non prononcés, si le montage change, le calque se déplace tout seul. Ne stockez pas de secondes.

Quatre étapes, sans exception

① Analyse textuelle de la tâche    Lisez subtitles.json, segmentez sémantiquement, répondez pour chaque segment :
                                   Tutoriel/Démonstration/Preuve, ou Concept/Logique/Transition ?
② Extraction d'images pour analyse    visual frame extrait 8-12 images, regardez-les vraiment.
                                   En pratique, sur 12 segments, 2 voient leur prédiction textuelle infirmée par l'image — cette étape n'est pas une formalité
③ Mesure de la fenêtre de mouvement   Calculez la différence de pixels entre images adjacentes, trouvez les moments de défilement/transition/action.
                                   Les calques ne couvrent que les fenêtres stables, les annotations disparaissent avant que l'image ne commence à bouger
④ Création et placement des calques   Écrivez le module → visual add → vérifiez calque par calque dans l'aperçu

Règles de jugement pour ②

L'image correspond exactement à ce qu'il dit     → Annotation : entourez, entourez précisément le mot qu'il dit. Ne masquez pas les preuves réelles
L'image est faiblement liée/vide                 → Animation plein écran : fond blanc, utilisez la bibliothèque de styles
L'image est suffisamment claire par elle-même    → Ne faites rien. C'est la réponse la plus courante (en pratique, 4 segments sur 13 ne bougent pas)

Le résultat de ③ est numérique, pas une impression

Coordonnées de l'annotation        Calculez via statistiques de pixels (scan de niveaux de gris pour trouver les lignes de texte), pas d'estimation visuelle — l'erreur d'estimation a déjà dépassé 50px
Moments d'interaction              Trouvez les changements brusques via différence de pixels image par image (en pratique, un saut de 4 à 335), l'annotation doit disparaître 0,2s avant
Fenêtre stable                     Le début contient souvent un défilement (il cherche le contenu), le calque commence à se lier à partir de l'image où ça s'arrête

Zoom : réfléchissez avant d'utiliser

Par défaut, pas de zoom.   Un enregistrement de 960x720 devient flou en zoomant, l'utilisateur le verra immédiatement
Si zoom indispensable      ≤1,6x, zone carrée de 62,5% centrée — la composition complète prime sur la lisibilité des petits caractères
Caractères trop petits      Utilisez une annotation pour guider le regard ; si vraiment besoin de lire, la réponse est de réenregistrer en haute résolution, pas de zoomer

Cycle de révision

Les répertoires de modules sont nommés par numéro (01-rapport-quotidien, 05-anim-tache-division), la piste chronologique affiche le nom du répertoire. L'utilisateur signale le numéro, vous modifiez ce calque, sans toucher aux autres.

Deux règles de modification des calques, chacune correspondant à un incident réel :

Modifier un calque nécessite de vérifier le module     Une fois un calque rétréci/allongé, les moments relatifs figés dans le module ne suivent pas —
                                                       le moment de sortie de l'annotation peut tomber après la fin du calque, et ne jamais apparaître
Validation par pixels     Vérifiez l'image, pas les propriétés DOM. Un iframe avec une « visibilité inversée correcte »
                          était physiquement hors de l'image — propriétés correctes, écran vide

Ce qu'il ne faut pas faire

  • Ne sautez jamais l'extraction d'images et la mesure de mouvement avant de créer les calques (deux types d'erreurs déjà commises : masquer des preuves réelles, annotation suspendue sur un défilement)
  • Ne remplissez pas chaque segment — tout recouvrir n'est pas le but, ne rien faire est une réponse courante
  • Ne stockez pas de secondes, n'estimez pas les coordonnées visuellement, n'ajoutez pas d'assombrissement sur fond blanc
  • N'utilisez pas d'images de substitution s'il n'y a pas de contenu réel
  • Choisissez le style depuis le registre, n'inventez pas
  • Les icônes de marque utilisent des glyphes officiels, pas de substituts dessinés à la main (un X a été dessiné avec deux lignes croisées, et l'utilisateur l'a remarqué). Si l'index local ne les contient pas, prenez le glyphe officiel monochrome depuis simple-icons (le noir et blanc s'accorde bien), enregistrez le fichier svg d'origine dans le répertoire du module pour référence ; la même marque ne doit apparaître que sous une seule forme dans une même vidéo.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

2789927464king-jpg/video-skill-ku

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

2789927464king-jpg/video-skill-ku

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=return_cut_review 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。

2789927464king-jpg/video-skill-ku

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

2789927464king-jpg/video-skill-ku

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

2789927464king-jpg/video-skill-ku

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

2789927464king-jpg/video-skill-ku

操作 chengfeng-videocut 剪辑工作台的已有工程,通过 Runtime CLI 查工程与词句位置、添加或替换画面覆盖层、移除画面、删除明确指定的词句或片段、拆分裁剪移动已有片段、调整画布比例并回读核验。用户说插入片段、删掉这句、移除动画、换个画面、调整顺序或管理时间线时使用;先区分画面覆盖与主轨顺延插入,不负责自动判断口误、创作动画、制作字幕、导出或排查安装故障。

2789927464king-jpg/video-skill-ku

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

2789927464king-jpg/video-skill-ku

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper),提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows,支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

Skills associés