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/entry_suggestion.py

View on GitHub
"""Where an interrupting narration block may be told to move.

`interrupts_source_sentence` suggests a sentence-end anchor the whole block can shift to.
These helpers keep that suggestion between the block's neighbours and clear of every other
block, and decide when a block is a back-to-back handoff that needs no entry check.
"""

import math


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


# A narration block that starts within this gap after another block's end is a
# back-to-back handoff: the source track is never exposed between the two.
CONNECTED_HANDOFF_SECONDS = 0.15
# A suggested entry farther than this from the authored one moves the block off the
# pictures it was written for; past it the author must rethink the block instead.
SUGGESTED_ANCHOR_MAX_SHIFT_SECONDS = 10.0


def _shift_is_clear(new_start, duration, other_spans):
    """The block moved whole to new_start neither overlaps nor abuts another block."""
    new_end = new_start + duration
    gap = CONNECTED_HANDOFF_SECONDS
    return all(
        new_end < other_start - gap or new_start > other_end + gap
        for other_start, other_end in other_spans
    )


def _nearest_safe_anchor(start, end, anchors, other_spans, window=(None, None)):
    """The anchor closest to `start` the whole block can move to (duration kept) without
    overlapping or abutting another block or leaving `window`, within
    SUGGESTED_ANCHOR_MAX_SHIFT_SECONDS; a later anchor wins a tie. None when none qualifies.

    `window` is the open (low, high) range the moved block must sit strictly inside: the
    neighbours' ends with the handoff gap, so a block never jumps over a neighbour (story
    order) and two adjacent blocks never get colliding suggestions. Either side may be None.
    """
    duration = end - start
    low, high = window
    candidates = [
        anchor
        for anchor in anchors
        if abs(anchor["time"] - start) <= SUGGESTED_ANCHOR_MAX_SHIFT_SECONDS
        and anchor["time"] >= 0
        and (low is None or anchor["time"] > low)
        and (high is None or anchor["time"] + duration < high)
        and _shift_is_clear(anchor["time"], duration, other_spans)
    ]
    if not candidates:
        return None
    return min(candidates, key=lambda anchor: (abs(anchor["time"] - start), -anchor["time"]))


def _valid_span(seg):
    """(start, end) of a block with a usable numeric window, else None."""
    if not isinstance(seg, dict):
        return None
    start, end = seg.get("start"), seg.get("end")
    if _is_number(start) and _is_number(end) and end > start:
        return start, end
    return None


def _other_block_spans(narration, idx):
    """(start, end) of every other block with a usable numeric window."""
    return [
        span
        for other_idx, other in enumerate(narration)
        if other_idx != idx and (span := _valid_span(other))
    ]


# Timeline edges are allowed positions; the open window bound sits this far outside.
_EDGE_EPSILON = 1e-6


def _suggestion_window(narration, idx, suggested_spans, limits=(None, None)):
    """Open (low, high) range a suggested move of block `idx` must stay strictly inside.

    Bounded by the previous and next valid blocks (narration is chronological) with the
    handoff gap. The previous block counts at both its authored and its own suggested
    window, so applying any subset of the suggestions keeps adjacent blocks apart and in
    order. `limits` is the closed (first, last) range the block must stay in: the output
    duration in cut_output; either side may be None.
    """
    gap = CONNECTED_HANDOFF_SECONDS
    low = high = None
    for prev_idx in range(idx - 1, -1, -1):
        span = _valid_span(narration[prev_idx])
        if span:
            low = max(span[1], suggested_spans.get(prev_idx, span)[1]) + gap
            break
    for next_idx in range(idx + 1, len(narration)):
        span = _valid_span(narration[next_idx])
        if span:
            high = span[0] - gap
            break
    first, last = limits
    if first is not None:
        low = max(x for x in (low, first - _EDGE_EPSILON) if x is not None)
    if last is not None:
        high = min(x for x in (high, last + _EDGE_EPSILON) if x is not None)
    return low, high


def _has_connected_predecessor(narration, idx, start):
    """A back-to-back narration handoff (<=150ms gap) does not expose the source track,
    so the next TTS block is not a new source-speech entry."""
    return any(
        other_start < start and -0.001 <= start - other_end <= CONNECTED_HANDOFF_SECONDS
        for other_start, other_end in _other_block_spans(narration, idx)
    )
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