scrawl — скилл для Claude Code: что делает и как установить
Скилл для Claude Code, который анализирует записи экрана в формате .scrawl, включая голос, клики и графические пометки. Помогает разобраться в баг-репортах, когда пользователь присылает видео вместо описания.
MIT 682 установок ★ 947 обновлён 2026-11-01
npx skills add kitlangton/scrawl --skill scrawl -a claude-codeЧто делает scrawl
Скилл обрабатывает записи экрана, где зафиксированы действия, речь и рисование поверх изображения. Он считывает данные из папки .scrawl, позволяя агенту просматривать ключевые кадры, расшифровку речи и пометки.
Для глубокого анализа используется CLI scrawl. Если команда scrawl не найдена в системе, укажите полный путь /Applications/Scrawl.app/Contents/MacOS/scrawl. Скилл работает только на macOS, где установлена программа Scrawl.
Какие задачи решает
- Разобрать баг-репорт по записи экрана
- Найти конкретный момент в видео по словам пользователя
- Экспортировать запись с наложенными пометками
- Извлечь кадры из видео для детального изучения
Примеры запросов агенту
- Посмотри, что происходит на
scrawlзаписи в папкеcaptures/ scrawl zoomна0:15в этом бандле, чтобы увидеть, куда кликнул пользователь
Как установить scrawl
1Через Skills CLI (Vercel)
npx skills add kitlangton/scrawl --skill scrawl -a claude-code2Вручную: положить файлы
~/.claude/skills/scrawl/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/scrawl/
1Через Skills CLI (Vercel)
npx skills add kitlangton/scrawl --skill scrawl -a codex2Вручную: положить файлы
.agents/skills/scrawl/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add kitlangton/scrawl --skill scrawl -a cursor2Вручную: положить файлы
.cursor/skills/scrawl/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install kitlangton/scrawl skills/scrawl2Вручную: положить файлы
.github/skills/scrawl/SKILL.md1Через Skills CLI (Vercel)
npx skills add kitlangton/scrawl --skill scrawl -a gemini-cli2Командой платформы
gemini skills install https://github.com/kitlangton/scrawl --path skills/scrawlВручную: положить файлы
.devin/skills/scrawl/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add kitlangton/scrawl --skill scrawl -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о scrawl
Как установить scrawl в Claude Code?
Выполните команду npx skills add kitlangton/scrawl --skill scrawl -a claude-code.
Что делает scrawl?
Он интерпретирует записи экрана в формате .scrawl, извлекая пометки, клики и аудио для анализа багов.
Что нужно для работы scrawl?
Установленная программа Scrawl на macOS и доступ к её бинарному файлу.
Исходный текст
SKILL.md · MIT
--- name: scrawl description: Read and dig into Scrawl screen captures, where someone recorded their screen while talking, clicking and drawing red marks on it. Use whenever a message contains a Scrawl capture (a line like `[scrawl 0:12 · App “Window” · /path/to/….scrawl]`, a `.scrawl` bundle path, or a contact-sheet.png from one), when the user says "look at my scrawl" or refers to something they just recorded or drew, or when you need the `scrawl` CLI to zoom into a moment, pull frames, send a capture to a session, or export one as video. --- # Scrawl captures Scrawl records someone's screen, voice, clicks and red ink, then packs the result into a `.scrawl` folder (a bundle). They send it to show you a problem instead of describing it, so the capture is the bug report. Read it closely before you answer, and don't ask them to explain again what the capture already shows. If something is unclear, look closer with `scrawl zoom` first. ## What a paste looks like ```text [scrawl 0:33 · OpenCode “Settings” · /Users/me/Library/Application Support/scrawl/captures/scrawl-1792432139176.scrawl] Open contact-sheet.png and frames/ in that folder before changing anything: the marks and words only make sense on the images, which can show more than the text does. Cropped to: the activity in OpenCode (full frames in frames-full/) - #1 (0:04) [clicked “New tab”] “Command T makes a new session, but here it should make a tab.” - #2 (0:07) “No, it doesn't.” - #3 (0:10) ⚑ “It says command shift B makes a new tab.” - #4 (0:18) clicked (x 0.51, y 0.93) ``` - The first line has the length, the app and window recorded, and the bundle path. - The next line asks you to open the images first. Do: the text is only what was said and done, and a problem can show in a frame without being marked or mentioned. - Each `#N (M:SS)` line is a keyframe: what they did at that moment in brackets, then what they said while it was on screen. A line with no quote has the action alone. - `⚑` means they flagged the moment on purpose. `⟨Name⟩` means the app reported a new screen. Lines starting `·` are events or values the app logged. - Optional lines near the top: `For session:` (where Scrawl sent it), `Screen:` with app context, `Note:`, and `Cropped to:`. - Coordinates are fractions of the captured area, from the top left (x 0.51 is just right of centre). When you answer, refer to moments the same way, as in "#3 (0:10)", so the person can find them on the contact sheet. ## Reading a bundle 1. Look at `contact-sheet.png` in the bundle first (it's often attached already). It shows every keyframe in time order, left to right and top to bottom, each with its number `N` in a small white chip in a top corner (the `#N` in `summary.md`). 2. Read the transcript lines next to it. Speech recognition mishears names and code terms, so trust the screen when the two disagree. 3. Open `frames/frame-NN.png` for any keyframe you need at full size (`frame-03.png` is #3). When the summary says `Cropped to:`, the uncropped screens are in `frames-full/`. What the drawings mean: - Red strokes, circles, underlines and arrows are the person's marks, and they point at the problem. Marks drawn on the same screen all show on one keyframe. When there are several, the text numbers them in drawing order (`✎① 0:06 …`, `✎② 0:09 …`); the image shows only the ink, so use `scrawl zoom --mark` to see which ink is which. - A ripple around the cursor shows a click or tap, and a finger trail shows a swipe. - A glowing red trail that tapers off is the laser pointer, used to point without leaving a mark. Other files: `scrawl.json` is the full manifest (keyframes, `marks` with shape and box, `events`, `transcript.words` with times, app `context`, and `autocrop`). `recording.mp4` or `recording.mov` and `audio.wav` are the source media. A `.media-pending` file means the video is still being copied from another Mac. ## The scrawl CLI `scrawl` is the Scrawl app's own binary. If `command -v scrawl` finds nothing, use `/Applications/Scrawl.app/Contents/MacOS/scrawl` (or the same path under `~/Applications`), and tell the person they can put it on PATH with Install in Scrawl's Settings › Agents. It runs only on the Mac with Scrawl installed. Anywhere else, read `contact-sheet.png`, `frames/` and `scrawl.json` directly. Every command takes a bundle path, and most default to `latest`, the newest capture. Quote the path, because it usually contains `Application Support`. ### Look closer at a moment Use `zoom` when the problem is motion (an animation, a jump, a flicker) or happens between keyframes, or when you can't tell what a mark points at: ```sh scrawl zoom <bundle> --at 0:21 # a time, M:SS or seconds scrawl zoom <bundle> --at "the width changes" # or a phrase they said scrawl zoom <bundle> --at 0:21 --span 1 --frames 16 --full scrawl zoom <bundle> --mark 2 # the mark shown as ✎② in the text scrawl zoom <bundle> --mark 1 --frame 4 # ✎① of keyframe #4, when several have a ✎① ``` It prints the path of a PNG sheet of frames around that moment, the time of each cell, and what was said. Open the PNG and look at it before you act on the feedback. `--span` is the seconds covered (default 2, a quarter of it before the moment), `--frames` the number of cells (default 12), and `--full` shows the whole screen instead of the crop. The cells are numbered from #1 within the sheet, so those numbers aren't keyframe numbers. `--mark` takes a mark's number from the text or its id (`m2`) and centres the sheet on the time it was drawn, with only that mark's ink, drawn whole from the moment it starts. `scrawl inspect <bundle> --marks` lists every mark (`#2 ✎② 0:09 marked (2 strokes) · m2`: keyframe, number, time, shape, what it was drawn on, id), and `--marks --json` gives the same as JSON. ### Other commands ```sh scrawl inspect <bundle> # summary.md, the text above scrawl inspect <bundle> --json # scrawl.json scrawl inspect <bundle> --marks # the marks, numbered as in the text [--json] scrawl frames <bundle> --from 0:04 --to 0:06 [--fps 4] # plain PNGs of a range; prints their paths scrawl send <bundle> --session ses_… # queue the capture into an OpenCode session scrawl send <bundle> --clipboard # copy the summary text to the clipboard scrawl export <bundle> [--out demo.mp4] [--zoom] [--crop auto|full|x,y,w,h] [--size 1920] ``` - `zoom` and `frames` write into `<bundle>/zoom/`. Leave the rest of the bundle as it is, because Scrawl manages those files and cleans them up. - `send` without `--session` goes to the session the capture was addressed to (the `For session:` line), and otherwise to the most recently active session. With a recorded destination it refuses a different `--session` unless you pass `--reroute`, so check with the person before rerouting. - `export` writes one `.mp4` with the ink and clicks burned in and the audio in sync (default `~/Movies/Scrawl/<bundle>.mp4`). `--zoom` eases in toward the activity. `--no-ink`, `--no-clicks`, `--hevc` and `--fps` are also available. - Video and audio go to the Trash 7 days after a capture unless the person changed that in Settings. After that `zoom`, `frames` and `export` can't read the video, but `frames/`, the contact sheet and `scrawl.json` remain. - `scrawl <command> --help` lists every flag, and `scrawl skill` prints this guide as the installed version knows it.
© kitlangton · MIT · kitlangton/scrawl