Skip to content
Skills Library
AI & agents · Conversion & formats

video-transcripts

/video-transcripts

Generate structured video transcripts from local files or video URLs using Gemini Files API. Use when a GitHub or Linear tracker item, comment, or attachment includes a screen recording, .mov, .mp4, or tracker-hosted video and you need a <video-transcripts> block instead of hand-written notes.

Repository
kitcn ↗
Licence
Apache-2.0
Last repository change
14.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
5
Deprecation

No signals detected. Repository changed on 14.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/generate_video_transcript.sh

What it does and when to use it

Generate structured video transcripts from local files or video URLs using Gemini Files API. Use when a GitHub or Linear tracker item, comment, or attachment includes a screen recording, .mov, .mp4, or tracker-hosted video and you need a <video-transcripts> block instead of hand-written notes.

Original author description

Generate structured video transcripts from local files or video URLs using Gemini Files API. Use when a GitHub or Linear tracker item, comment, or attachment includes a screen recording, .mov, .mp4, or tracker-hosted video and you need a <video-transcripts> block instead of hand-written notes.

How it works

  1. Quick Start
  2. Use This When
  3. Workflow
  4. Output Contract
  5. Model Strategy
  6. Notes
Original SKILL.md headings · 131 lines, 851 words
SKILL.md preview
---
name: video-transcripts
description: Generate structured video transcripts from local files or video URLs using Gemini Files API. Use when a GitHub or Linear tracker item, comment, or attachment includes a screen recording, .mov, .mp4, or tracker-hosted video and you need a <video-transcripts> block instead of hand-written notes.
disable-model-invocation: true
---

# Video Transcripts

## Quick Start

Run the helper once per relevant video:

```bash
bash .agents/skills/video-transcripts/scripts/generate_video_transcript.sh \
  "https://uploads.linear.app/.../screen-recording.mov" \
  --title "PDF preview hyperlinks trigger leave-page modal"
```

Or for a GitHub attachment:

```bash
bash .agents/skills/video-transcripts/scripts/generate_video_transcript.sh \
  "https://github.com/user-attachments/assets/..." \
  --title "Slash menu loses selection after confirm"
```

Or for a Screencastify watch page:

```bash
bash .agents/skills/video-transcripts/scripts/generate_video_transcript.sh \
  "https://app.screencastify.com/watch/..." \
  --title "Bulk send expands filtered recipients"
```

Or for a local file:

```bash
bash .agents/skills/video-transcripts/scripts/generate_video_transcript.sh \
  "/absolute/path/to/video.mov" \
  --title "Preview hyperlink exits workflow"
```

For auth-gated Linear uploads, the helper automatically retries with cookies from the local Linear desktop app on macOS. For private GitHub asset URLs, it retries with `GITHUB_TOKEN`, `GH_TOKEN`, or `gh auth token` when available.

## Use This When

- A GitHub or Linear issue, PR, or comment includes a screen recording.
- An attachment URL points to `uploads.linear.app`.
- An attachment URL points to a GitHub attachment or private GitHub asset host.
- A tracker links to a public Screencastify watch page.
- You need timeline-style transcript lines, not a vague summary.
- You want the result in this exact XML shape:

```xml
<video-transcripts>
<video-transcript title="...">
[00:00] (...)
</video-transcript>
</video-transcripts>
```

## Workflow

1. Run the helper once for each relevant video.
2. Give each run a short, bug-focused `--title`.
3. For tracked work, the canonical shared cache should live in the tracker next to the evidence it describes.
4. If the video is in the issue or PR body, use a top-level tracker comment.
5. If the video is in a Linear comment, post the transcript cache as a reply to that specific comment.
6. If the video is in a GitHub issue or PR comment, use one dedicated top-level cache comment for that source comment's video set. GitHub has no replies, so keep cache comments separated by source container instead of merging unrelated comment videos together.
7. Cache comment or reply body should start with a transcript source link, then
   the timestamp lines:

````md
[[Transcript](link to video or comment if not available)]
[00:00] (...)
````

8. When caching helper XML, strip the `<video-transcripts>` and
   `<video-transcript ...>` wrapper lines and paste only timestamp lines after
   the source link.
9. If there are multiple videos in the same source container, repeat the
   `[[Transcript](...)]` source link plus timestamp lines for each video.
10. Do not hand-write or paraphrase video behavior when the helper can run. Use the actual transcript output.
11. Link `[[Transcript](...)]` to the video URL when available. If the video URL is not available or is unstable, link to the source comment that contains the video.
12. For signed tracker-hosted URLs like `uploads.linear.app`, strip the query string so a new signature does not invalidate an otherwise valid cache entry. For Screencastify, cache against the stable `https://app.screencastify.com/watch/<id>` URL, not the signed `dash-assets` HLS URLs.
13. Do not add decorative metadata like `title` to cached transcript entries unless a later workflow truly needs it.
14. Before re-transcribing for tracked work, match cache entries by source container first:
    - one cache comment for issue or PR body videos
    - one Linear reply per comment containing video(s)
    - one dedicated GitHub cache comment per issue or PR comment containing video(s)
15. If the matching cache already covers the current normalized video keys for that source container, reuse it. Only transcribe missing or new video evidence.
16. Do not use `docs/` for raw tracker transcript cache. That is durable repo knowledge space, not raw issue evidence.
17. If you invoke this through `codex exec`, prefer `-o <file>` so the final XML is captured without CLI progress chatter.

## Output Contract

- Return XML, not Markdown.
- Use one `[MM:SS] (...)` line per observed action or system response.
- Quote visible UI text when legible.
- Describe only visible actions, screen changes, and audible speech if present.
- Do not invent hidden state, motives, or implementation details.
- Prefer concise, high-signal lines over per-keystroke sludge.

## Model Strategy

The helper defaults to `gemini-3.1-flash-lite-preview` for cost efficiency.

If that output is malformed, too thin, or obviously noisy, it retries with `gemini-3-flash-preview`.

For Gemini 3 models, the helper forces minimal thinking so output budget goes to the transcript instead of hidden reasoning.

Override with:

```bash
VIDEO_TRANSCRIPTS_MODEL=gemini-3-flash-preview bash .agents/skills/video-transcripts/scripts/generate_video_transcript.sh ...
```

Or:

```bash
bash .agents/skills/video-transcripts/scripts/generate_video_transcript.sh ... \
  --model gemini-2.5-flash
```

## Notes

- The helper accepts a local file path or remote URL.
- For `uploads.linear.app` URLs, it first tries `LINEAR_COOKIE_HEADER`, then `LINEAR_COOKIES_DB`, then falls back to the local Linear desktop cookie store at `~/Library/Application Support/Linear/Cookies`.
- For GitHub asset URLs, it first tries `GITHUB_TOKEN`, then `GH_TOKEN`, then `gh auth token`, then falls back to an unauthenticated download.
- For Screencastify watch URLs, it calls `https://umbrella.svc.screencastify.com/api/umbrellaService/watch/<id>`, resolves the signed HLS manifest, rewrites child playlists so segments keep the signature, and remuxes the recording with `ffmpeg`.
- Screencastify URL support requires `ffmpeg`.
- It looks for `GEMINI_API_KEY`, then `GOOGLE_API_KEY`.
- If neither is set, it tries `~/.bash_profile` before failing.
- Use `--debug-dir <dir>` when you want request and response artifacts saved.
- Quality gate rejects obvious low-signal transcripts such as repeated partial typing runs and falls back automatically.
Files in this package (2)
  • SKILL.md 6 KB
  • scripts/generate_video_transcript.sh 22 KB

Versions

RepositoryScoreLicence
This page · udecode/kitcn100Apache-2.0
firecrawl/firecrawl-claude-plugin86MIT

Database snapshot: 13.11.2026 · package version 95fc89af557e (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100video-query
    Analyzes video files using Google Gemini API and answers questions about content. Triggers on keywords: video query, analyze video, video analysis, query video
  • 100ac-tools-video-query
    Analyzes video files using Google Gemini API and answers questions about content. Triggers on keywords: video query, analyze video, video analysis, query video
  • 100gemini-api-dev
    Use this skill when building applications with Gemini models, Gemini API, working with multimodal content (text, images, audio, video), implementing function calling, using structured outputs, or n...
  • 100gemini-api-dev
    Use this skill when building applications with Gemini API hosted models, including Gemini and Gemma 4, working with multimodal content (text, images, audio, video), implementing function calling, using structured outputs, or needing current model specifications.
  • 100gemini-api-dev
    Use this skill when building applications with Gemini API hosted models, including Gemini and Gemma 4, working with multimodal content (text, images, audio, video), implementing function calling, using structured outputs, or needing current model specifications.
  • 100source-to-skill
    Use when compiling raw knowledge sources (transcripts, docs, PDFs, books, video notes) into structured, operational agent skills.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.