Skip to content

zenstory-ai/video-recap-skills / skills/video-recap

video-recap

Verified

把一段或多集视频做成带画框字幕的中文解说成片或纯原声高光短片。用户提供 .mp4 / .mov / .mkv / .webm,要求做影视解说、短剧二创、加旁白配音、跨集混剪或导出剪映草稿时使用;串联完成看片识台词、定主线与留原声、按台词停顿切镜头、写词检查、TTS 配音与混音加字幕。触发词:视频解说、影视解说、视频旁白、生成解说、视频 recap、video recap、voiceover、narration、recap。

FileKindSize
SKILL.mdskill md18.4 KB
assets/dashboard/app.jsscript16.2 KB
assets/dashboard/index.htmlother867 B
assets/dashboard/styles.cssother22.6 KB
assets/dashboard/tokens.cssother8.9 KB
assets/dashboard/views.jsscript31.4 KB
references/audio-modes.mdmarkdown3.6 KB
references/config-playbook.mdmarkdown8.1 KB
references/creative-editing-playbook.mdmarkdown12.3 KB
references/data-schema.mdmarkdown34.6 KB
references/index-tts.mdmarkdown2.1 KB
references/jianying/LICENSE.duo-videoother1.0 KB
references/jianying/SOURCE.mdmarkdown703 B
references/jianying/empty_draft_meta_info.jsonconfig1.7 KB
references/jianying/empty_jy_material_video.jsonconfig1.8 KB
references/jianying/empty_jy_meta_material_value.jsonconfig358 B
references/jianying/empty_jy_project_info.jsonconfig3.6 KB
references/jianying/empty_jy_segment.jsonconfig1.3 KB
references/jianying/empty_jy_text_styles.jsonconfig440 B
references/jianying/empty_yj_material_audio.jsonconfig865 B
references/jianying/empty_yj_material_text.jsonconfig2.4 KB
references/packaging.mdmarkdown6.8 KB
references/promotional-copy.mdmarkdown4.1 KB
references/prompt-templates.mdmarkdown2.0 KB
references/research-guide.mdmarkdown2.7 KB
references/resource-library.mdmarkdown12.1 KB
references/shot-review.mdmarkdown4.8 KB
scripts/agent_text.pyscript2.7 KB
scripts/artifacts.pyscript972 B
scripts/asr.pyscript12.5 KB
scripts/asr_timing_evidence.pyscript4.2 KB
scripts/assemble.pyscript31.0 KB
scripts/assemble_constants.pyscript894 B
scripts/assembly_contract.pyscript10.3 KB
scripts/assembly_settings.pyscript3.8 KB
scripts/audio_automation.pyscript6.6 KB
scripts/audio_mix.pyscript18.5 KB
scripts/briefing/__init__.pyscript101 B
scripts/briefing/builder.pyscript31.1 KB
scripts/briefing/context.pyscript6.1 KB
scripts/briefing/timeline.pyscript23.0 KB
scripts/codec_peak.pyscript5.1 KB
scripts/cut.pyscript148 B
scripts/cut_cli.pyscript12.4 KB
scripts/cut_contract.pyscript13.3 KB
scripts/cut_qc.pyscript1.9 KB
scripts/cut_render.pyscript13.2 KB
scripts/dashboard/__init__.pyscript159 B
scripts/dashboard/data.pyscript24.6 KB
scripts/dashboard/io.pyscript7.1 KB
scripts/dashboard/runs.pyscript21.8 KB
scripts/dashboard/templates.pyscript9.6 KB
scripts/dashboard_server.pyscript9.3 KB
scripts/detect.pyscript22.2 KB
scripts/doctor.pyexecutablescript12.9 KB
scripts/entry_suggestion.pyscript4.6 KB
scripts/export_jianying.pyscript5.6 KB
scripts/extract.pyscript2.5 KB
scripts/final_qc.pyscript19.0 KB
scripts/frame_grid.pyscript10.6 KB
scripts/jianying/__init__.pyscript49 B
scripts/jianying/builders.pyscript11.3 KB
scripts/jianying/model.pyscript2.7 KB
scripts/jianying/optional.pyscript1012 B
scripts/jianying/schema.pyscript2.5 KB
scripts/jianying/templates.pyscript1.0 KB
scripts/jianying/timeline_contract.pyscript5.8 KB
scripts/jianying/tracks.pyscript2.0 KB
scripts/jianying/writer.pyscript7.8 KB
scripts/lib.pyscript29.6 KB
scripts/library.pyscript31.1 KB
scripts/lint_summary.pyscript5.0 KB
scripts/loudness.pyscript14.7 KB
scripts/materials.pyscript22.1 KB
scripts/media.pyscript18.8 KB
scripts/narration_audio.pyscript13.5 KB
scripts/narration_lint.pyscript24.1 KB
scripts/narrative_selection.pyscript8.9 KB
scripts/packaging.pyscript6.1 KB
scripts/packaging_fonts.pyscript12.0 KB
scripts/packaging_plates.pyscript31.2 KB
scripts/packaging_studio.pyscript34.1 KB
scripts/providers/__init__.pyscript72 B
scripts/providers/fish_audio.pyscript3.1 KB
scripts/providers/index_tts.pyscript8.8 KB
scripts/recap.pyscript183 B
scripts/recap_cli.pyscript6.9 KB
scripts/recap_inspect.pyscript16.5 KB
scripts/recap_runner.pyscript22.0 KB
scripts/recap_runtime.pyscript11.8 KB
scripts/recap_source.pyscript1.8 KB
scripts/recap_stage_qc.pyscript2.7 KB
scripts/recap_timeline.pyscript7.7 KB
scripts/render_preflight.pyscript1.7 KB
scripts/resources/__init__.pyscript200 B
scripts/resources/lock.pyscript6.8 KB
scripts/resources/project_binding.pyscript16.1 KB
scripts/sentence_boundaries.pyscript28.8 KB
scripts/sentence_gate.pyscript8.6 KB
scripts/sfx_mix.pyscript14.6 KB
scripts/shot_review.pyscript18.9 KB
scripts/source_subtitles.pyscript7.2 KB
scripts/speech_ownership.pyscript9.3 KB
scripts/storyboard.pyscript21.8 KB
scripts/subtitles/__init__.pyscript56 B
scripts/subtitles/core.pyscript19.0 KB
scripts/subtitles/render.pyscript8.0 KB
scripts/timeline.pyscript8.2 KB
scripts/timeline_emit.pyscript5.4 KB
scripts/tts_audio.pyscript9.6 KB
scripts/tts_cache.pyscript4.5 KB
scripts/understand.pyscript171 B
scripts/understanding_brief.pyscript6.3 KB
scripts/understanding_cache.pyscript8.0 KB
scripts/understanding_runner.pyscript9.8 KB
scripts/understanding_storyboard.pyscript11.9 KB
scripts/validate.pyscript5.7 KB
scripts/visual_render.pyscript10.1 KB
scripts/vlm.pyscript16.4 KB
scripts/voiceover.pyscript28.0 KB

scripts/jianying/timeline_contract.py

View on GitHub
"""Timeline validation at the JianYing adapter boundary."""

import copy
import math


CURRENT_SCHEMA_VERSION = 2
# Hand-authoring fields the exporter once mapped to JianYing (speed, reverse,
# transitions, masks, LUTs, green screen, rich text, resource tracks). No pipeline
# stage emits them; they are rejected so an old hand-written timeline fails loudly
# instead of silently exporting a draft without the effect it asked for.
REMOVED_ITEM_FIELDS = (
    "chroma", "compound", "flip", "green_background", "lut", "mask", "opacity",
    "reverse", "reverse_path", "rotation_degrees", "speed", "style", "style_id",
    "transition", "words",
)
REMOVED_ROOT_FIELDS = ("resource_packages", "style_presets")


def _error(path, expectation):
    raise ValueError(f"invalid timeline {path}: {expectation}")


def _is_number(value):
    return isinstance(value, (int, float)) and not isinstance(value, bool) and math.isfinite(value)


def _field_path(path, key):
    return f"{path}.{key}" if path else key


def _require_number(container, key, path, *, minimum=None):
    field_path = _field_path(path, key)
    if key not in container or not _is_number(container[key]):
        _error(field_path, "must be a finite number")
    value = container[key]
    if minimum is not None and value < minimum:
        _error(field_path, f"must be >= {minimum}")
    return value


def _require_string(container, key, path):
    value = container.get(key)
    if not isinstance(value, str) or not value:
        _error(_field_path(path, key), "must be a non-empty string")
    return value


def _reject_removed(container, fields, path):
    for field in fields:
        if field in container:
            _error(_field_path(path, field), "JianYing authoring extension is no longer supported")


def _validate_span(item, path, start_key="timeline_start", end_key="timeline_end"):
    start = _require_number(item, start_key, path, minimum=0)
    end = _require_number(item, end_key, path, minimum=0)
    if end <= start:
        _error(f"{path}.{end_key}", f"must be greater than {start_key}")


def _validate_item(item, path):
    if not isinstance(item, dict):
        _error(path, "must be an object")
    _reject_removed(item, REMOVED_ITEM_FIELDS, path)
    _validate_span(item, path)
    for field in ("scale", "position"):
        if field in item and not isinstance(item[field], dict):
            _error(f"{path}.{field}", "must be an object")


def _validate_video_clip(clip, path):
    _validate_item(clip, path)
    _require_string(clip, "source_path", path)
    _validate_span(clip, path, "source_start", "source_end")
    if "audio" in clip and not isinstance(clip["audio"], dict):
        _error(f"{path}.audio", "must be an object")


def _validate_segment(segment, path, kind):
    _validate_item(segment, path)
    if kind in {"audio", "image"}:
        _require_string(segment, "source_path", path)
    elif not isinstance(segment.get("text"), str):
        _error(f"{path}.text", "must be a string")


def _validate_track(track, path):
    if not isinstance(track, dict):
        _error(path, "must be an object")
    kind = _require_string(track, "kind", path)
    if "name" in track and (not isinstance(track["name"], str) or not track["name"]):
        _error(f"{path}.name", "must be a non-empty string")

    if kind == "video":
        clips = track.get("clips")
        if not isinstance(clips, list):
            _error(f"{path}.clips", "must be an array")
        for index, clip in enumerate(clips):
            _validate_video_clip(clip, f"{path}.clips[{index}]")
        return

    if kind in {"audio", "image", "text"}:
        segments = track.get("segments")
        if not isinstance(segments, list):
            _error(f"{path}.segments", "must be an array")
        if kind == "audio":
            if "role" in track and not isinstance(track["role"], str):
                _error(f"{path}.role", "must be a string")
            if "loop" in track and not isinstance(track["loop"], bool):
                _error(f"{path}.loop", "must be a boolean")
        for index, segment in enumerate(segments):
            _validate_segment(segment, f"{path}.segments[{index}]", kind)
        return

    _error(f"{path}.kind", f"unsupported track kind {kind!r}")


def _validate(timeline):
    canvas = timeline.get("canvas")
    if not isinstance(canvas, dict):
        _error("canvas", "must be an object")
    for dimension in ("width", "height"):
        value = canvas.get(dimension)
        if not isinstance(value, int) or isinstance(value, bool) or value <= 0:
            _error(f"canvas.{dimension}", "must be a positive integer")
    fps = _require_number(canvas, "fps", "canvas")
    if fps <= 0:
        _error("canvas.fps", "must be greater than 0")

    _require_number(timeline, "duration", "", minimum=0)
    _reject_removed(timeline, REMOVED_ROOT_FIELDS, "")
    tracks = timeline.get("tracks")
    if not isinstance(tracks, list):
        _error("tracks", "must be an array")
    for index, track in enumerate(tracks):
        _validate_track(track, f"tracks[{index}]")


def normalize_timeline(timeline):
    """Return a validated copy of a schema-v2 timeline (the version timeline.py emits)."""
    if not isinstance(timeline, dict):
        _error("root", "must be an object")
    schema_version = timeline.get("schema_version")
    if not isinstance(schema_version, int) or isinstance(schema_version, bool):
        _error("schema_version", f"must be integer {CURRENT_SCHEMA_VERSION}")
    if schema_version != CURRENT_SCHEMA_VERSION:
        raise ValueError(
            f"unsupported timeline schema_version {schema_version}; "
            f"only {CURRENT_SCHEMA_VERSION} is supported (a v1 timeline only needs "
            f"schema_version set to {CURRENT_SCHEMA_VERSION})"
        )

    normalized = copy.deepcopy(timeline)
    _validate(normalized)
    return normalized
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall