跳到主内容
智客 ZICQ

技能库 智客分类:媒体内容 webreel

Webreel

创建并记录有脚本的浏览器用webreel演示视频. 生成 MP4, GIF, 或WebM 有光标动画, keystroke 覆盖,以及 JSON 配置的音效. 当用户想要记录演示,创建浏览器视频,编辑webreel配置,生成屏幕记录,预览演示,或以任何方式与webreel合作时使用.

178 安装量

官方网址:skills.sh

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

创建并记录有脚本的浏览器用webreel演示视频. 生成 MP4, GIF, 或带有光标动画的 WebM 录音, 按键覆盖, 以及 JSON 配置的音效

何时用

用户想要录制演示,创建浏览器视频,编辑 webreel 配置,生成屏幕记录,预览演示,或以任何方式与webreel合作

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:webreel、Installation、Prerequisites、.gitignore、Quick start、Scaffold a config。 其中含规范建议的小节:分步指令。

文件分析

文件分析:这是一份仅含 SKILL.md 的指令型技能,代理激活后整份正文进入上下文。

官方 description(原文)

Create and record scripted browser demo videos with webreel. Generates MP4, GIF, or WebM recordings with cursor animation, keystroke overlays, and sound effects from a JSON config. Use when the user wants to record a demo, create a browser video, edit a webreel config, generate a screen recording, preview a demo, or work with webreel in any way.

webreelInstallationPrerequisites.gitignoreQuick startScaffold a configEdit webreel.config.json with your stepsPreview in a visible browser (no recording)Record the videoCLI commandsinitrecord

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
webreel
description
Create and record scripted browser demo videos with webreel. Generates MP4, GIF, or WebM recordings with cursor animation, keystroke overlays, and sound effects from a JSON config. Use when the user wants to record a demo, create a browser video, edit a webreel config, generate a screen recording, preview a demo, or work with webreel in any way.
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「webreel」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-e6925b57b7993aaf-%E7%BD%91%E9%A1%B5.html
请存为 .cursor/skills/webreel/SKILL.md 或 .claude/skills/webreel/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。

npx skills add 'https://github.com/vercel-labs/webreel' --list

npx skills add 'https://github.com/vercel-labs/webreel' --skill 'webreel'

CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。

阅读排版
--- name: webreel description: Create and record scripted browser demo videos with webreel. Generates MP4, GIF, or WebM recordings with cursor animation, keystroke overlays, and sound effects from a JSON config. Use when the user wants to record a demo, create a browser video, edit a webreel config, generate a screen recording, preview a demo, or work with webreel in any way. --- # webreel webreel records scripted browser demos as MP4, GIF, or WebM with cursor animation, keystroke overlays, and sound effects. You define steps in a JSON config, and webreel drives headless Chrome, captures frames, and encodes with ffmpeg. ## Installation Install webreel as a project dependency so the version is pinned in the lockfile. This ensures deterministic recordings across machines and CI. ```bash npm install webreel ``` If the project already has webreel in its dependencies, skip this step. ## Prerequisites webreel requires Chrome and ffmpeg, but you do NOT need to install them manually. Both are automatically downloaded to `~/.webreel` on first run if not already present. Do not install Chrome or Chromium via puppeteer, playwright, or any other tool. webreel manages its own browser. To download dependencies explicitly, or to fix corrupted/broken binaries: ```bash npx webreel install npx webreel install --force # delete cached binaries and re-download ``` To override the auto-downloaded binaries, set these environment variables: - `CHROME_PATH` - path to a Chrome or Chromium binary (used for preview) - `CHROME_HEADLESS_PATH` - path to a chrome-headless-shell binary (used for recording) - `FFMPEG_PATH` - path to an ffmpeg binary If a recording fails with "No inspectable targets" or similar browser errors, the issue is almost certainly in the webreel config (wrong `waitFor`, missing element, timing), not a missing browser. Check the config and use `--verbose` to debug. ## .gitignore The `.webreel` directory is created at the project root during recording (frames, intermediate files). Add it to `.gitignore`: ``` .webreel ``` ## Quick start ```bash # Scaffold a config npx webreel init --name my-demo --url https://example.com # Edit webreel.config.json with your steps # Preview in a visible browser (no recording) npx webreel preview my-demo # Record the video npx webreel record my-demo ``` `npx` resolves to the locally installed version when webreel is in `devDependencies`. Output lands in `videos/` by default (configurable via `outDir`). ## CLI commands ### init Scaffold a new `webreel.config.json`. ```bash webreel init webreel init --name login-flow --url https://myapp.com webreel init --name hero -o hero.config.json ``` Flags: `--name` (video name), `--url` (starting URL), `-o, --output` (output file path). ### record Record one or more videos. ```bash webreel record # all videos in config webreel record hero login # specific videos by name webreel record -c custom.config.json # custom config path webreel record --watch # re-record on config change webreel record --verbose # log each step webreel record --dry-run # print resolved config only webreel record --frames # save raw JPEGs to .webreel/frames/ ``` ### preview Run steps in a visible browser without recording. ```bash webreel preview webreel preview hero --verbose ``` ### composite Re-apply overlays (cursor, HUD, sfx) to existing raw video without re-recording. Useful for tweaking theme settings. ```bash webreel composite webreel composite hero ``` ### install Download Chrome and ffmpeg to `~/.webreel`. Also use this to fix corrupted or broken binaries. ```bash webreel install webreel install --force # delete cached binaries and re-download ``` ### validate Check config for errors without running anything. ```bash webreel validate webreel validate -c custom.config.json ``` ## Config structure Config files are auto-discovered as `webreel.config.json` (or `.ts`, `.mts`, `.js`, `.mjs`). Use `-c` to specify a custom path. ### Top-level fields | Field | Default | Description | | -------------- | ----------- | ------------------------------------------------ | | `$schema` | - | `"https://webreel.dev/schema/v1.json"` | | `outDir` | `"videos/"` | Output directory for rendered videos | | `baseUrl` | `""` | Base URL prepended to relative video URLs | | `viewport` | `1080x1080` | Default viewport `{ width, height }` | | `theme` | - | Cursor and HUD overlay theme | | `sfx` | - | Sound effect settings | | `include` | - | Array of step file paths prepended to all videos | | `defaultDelay` | - | Default delay (ms) appended after each step | | `clickDwell` | - | Cursor dwell time (ms) before a click | ### Per-video fields Each entry in the `videos` map supports: | Field | Default | Description | | -------------- | -------------- | -------------------------------------------------- | | `url` | required | URL to open (absolute or relative to `baseUrl`) | | `viewport` | inherited | Override viewport `{ width, height }` | | `zoom` | - | CSS zoom factor | | `waitFor` | - | Selector or text to wait for before starting steps | | `output` | `".mp4"` | Output path (`.mp4`, `.gif`, `.webm`) | | `thumbnail` | `{ time: 0 }` | Thumbnail config, or `{ enabled: false }` | | `include` | inherited | Step files to prepend | | `theme` | inherited | Override theme | | `sfx` | inherited | Override sound effects | | `defaultDelay` | inherited | Override default delay | | `clickDwell` | inherited | Override click dwell | | `fps` | `60` | Frame rate | | `quality` | `80` | Encoding quality (1-100) | | `steps` | required | Array of step objects | ### Videos map Videos are keyed by name in the config: ```json { "videos": { "hero": { "url": "...", "steps": [...] }, "login": { "url": "...", "steps": [...] } } } ``` Record specific videos by name: `webreel record hero login`. ## Step types Each step has an `action` field. Most steps accept optional `label`, `delay` (ms after step), and `description` fields. | Action | Key fields | Purpose | | ------------ | ------------------------------------------- | ---------------------------------- | | `pause` | `ms` | Wait for a duration | | `click` | `text` or `selector`, `within`, `modifiers` | Click an element | | `type` | `text`, `selector`, `within`, `charDelay` | Type text into an input | | `key` | `key`, `target` | Press a key combo (e.g. `"cmd+s"`) | | `drag` | `from`, `to` (element targets) | Drag between two elements | | `scroll` | `x`, `y`, `selector` | Scroll the page or an element | | `wait` | `selector` or `text`, `timeout` | Wait for an element to appear | | `moveTo` | `text` or `selector`, `within` | Move cursor to an element | | `navigate` | `url` | Navigate to a new URL | | `hover` | `text` or `selector`, `within` | Hover over an element | | `select` | `selector`, `value` | Select a dropdown value | | `screenshot` | `output` | Capture a PNG screenshot | For full field details on every step type, see [steps-reference.md](steps-reference.md). ## Element targeting Many steps target elements using these fields: - `text` - match by visible text content - `selector` - match by CSS selector - `within` - narrow the search to a parent matching this CSS selector You can use `text` or `selector` (not both). `within` is optional and scopes the search. ```json { "action": "click", "text": "Submit" } { "action": "click", "selector": "#submit-btn" } { "action": "click", "text": "Submit", "within": ".modal" } ``` ## Viewport presets Use preset names as string values for `viewport`, or specify `{ width, height }`: `desktop` (1920x1080), `desktop-hd` (2560x1440), `laptop` (1366x768), `macbook-air` (1440x900), `macbook-pro` (1512x982), `ipad` (1024x1366), `ipad-pro` (834x1194), `ipad-mini` (768x1024), `iphone-15` (393x852), `iphone-15-pro-max` (430x932), `iphone-se` (375x667), `pixel-8` (412x915), `galaxy-s24` (360x780). ## Theme Customize cursor appearance and keystroke HUD: ```json { "theme": { "cursor": { "image": "./cursor.svg", "size": 32, "hotspot": "center" }, "hud": { "background": "rgba(30, 41, 59, 0.85)", "color": "#e2e8f0", "fontSize": 48, "fontFamily": "\"SF Mono\", monospace", "borderRadius": 12, "position": "top" } } } ``` - `cursor.image` - path to a custom cursor SVG or PNG - `cursor.size` - cursor size in pixels - `cursor.hotspot` - `"top-left"` (default) or `"center"` - `hud.position` - `"top"` or `"bottom"` ## Common patterns ### Shared steps via include Factor out reusable step sequences (e.g. dismissing a cookie banner) into JSON files: ```json // steps/dismiss-banner.json { "steps": [ { "action": "wait", "selector": ".cookie-banner", "timeout": 5000 }, { "action": "click", "selector": ".accept-btn", "delay": 300 } ] } ``` Reference them in the config: ```json { "include": ["./steps/dismiss-banner.json"], "videos": { ... } } ``` ### Multiple videos in one config Define several videos in the `videos` map. Shared settings (`viewport`, `theme`, `defaultDelay`) are inherited from the top level. ### Environment variables Config values support `$VAR` and `${VAR}` substitution from the environment. ### Output formats Set the `output` extension to control format: `.mp4` (default), `.gif`, `.webm`. ```json { "output": "demo.gif" } ``` ## Tips - Always set `waitFor` on a video to ensure the page is ready before steps run. - Use `delay` on individual steps to control pacing between actions. - Use `--watch` during development for automatic re-recording on config changes. - Use `composite` to iterate on theme/overlay settings without re-recording. - Use `--verbose` to debug step execution. - Use `--dry-run` to inspect the fully resolved config (includes, env vars, defaults). - Use `zoom` to scale up small UIs for readability in the recording. - Start with `preview` to verify steps work before committing to a full recording. ## Reference files - [steps-reference.md](steps-reference.md) - detailed docs for all 12 step types - [examples.md](examples.md) - annotated config examples for common use cases

相关技能

媒体内容

Nano Banana Pro

以纳米·香蕉Pro(Gemini 3 Pro Image)来生成/编辑图像. 用于创建/修改请求,包括编辑。 支持文本到图像+图像到图像; 1K/2K/4K; 使用 -- input-image.

媒体内容

Youtube Watcher

从YouTube视频中获取并读取文字记录. 需要汇总视频时使用,回答有关视频内容的问题,或者从中提取信息.

媒体内容

Atxp

Access ATXP支付API工具用于网页搜索,AI图像生成,音乐创建,视频生成,X/Twitter搜索,电子邮件,代理账户管理. 当用户需要实时网络搜索时使用,AI生成的媒体(图像,音乐,视频),X/Twitter搜索,发送/接收电子邮件,或创建和资助代理账户. 需要通过“ …

媒体内容

Youtube

YouTube Data API与管理的OAuth的集成. 搜索视频,管理播放列表,访问频道数据,并与评论互动. 用户想与YouTube互动时使用此技能. 对于其他第三方应用,使用api-gateway技能(https://clawhub.ai/byungkyu/api-gate…