---
id: oxbshw/watch-skill/extracting-structure
version: "1a029e82"
license: MIT
install: manual
updated: 2026-07-12
---

# extracting-structure — Pull structured data from videos you've already watched: titled chapters with timestamps for long content, pinpointed bug reports with error frames and OCR text, or opening-hook analysis scored across attention, pacing, visuals, and on-screen text. All answers come straight from the persistent index with no extra model calls.

Publisher: oxbshw · Stars: 236 · Updated: 2026-07-12

Install (manual): `git clone https://github.com/oxbshw/watch-skill`

## SKILL.md

# Extracting structure

Three extractors turn an already-watched video into something structured.
All of them answer straight from the persistent index — deterministic, no
extra model calls. The video must be watched first (see `watching-videos`).

## Chapters

```bash
watch-skill extract chapters <video_id-or-source>
```

Titled chapters with start/end timestamps, built from scene changes plus
transcript topic shifts. Good for long tutorials, lectures, meetings —
give the user the chapter list with timestamps, not a prose summary.

## Bug report from a screen recording

```bash
watch-skill extract bug-report <video_id-or-source>
```

Pinpoints where an error appears: timestamp, the exact frame, the
on-screen error text as OCR read it, and the steps that led up to it
(from the transcript/actions preceding the failure). Returns
`found: false` honestly when no error signal exists — report that as
"no error found in the recording", not as an error.

Paste the output into the user's issue tracker format when they ask for
a fileable report; the frame path is the attachment.

## Hook analysis (creators)

```bash
watch-skill extract hook <video_id-or-source> [--seconds 15]
```

Scores the opening seconds on four measured axes — attention trigger in
the opening line, speech pacing, visual change rate, on-screen text —
each with an actionable critique, plus a 0–100 score and verdict. Give
the user the per-axis critiques; the number alone helps nobody.


[View on SkillFed](https://skillfed.io/oxbshw/watch-skill/extracting-structure) · [View on GitHub](https://github.com/oxbshw/watch-skill)