← Back to Skills Marketplace
205
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install sjht-cam-anno
Description
安防摄像头视频 VL 模型微调数据集标注工具。用于从安防摄像头视频中提取关键帧、分析视频内容、生成结构化标注(含环境/人物/行为/风险描述),并输出符合 dataset.jsonl 格式的微调训练数据。Use when 用户需要对安防摄像头视频进行数据标注、生成 VL 模型训练数据集、处理 /root/hair-...
Usage Guidance
Before installing or running this skill, consider the following:
- Verify ffmpeg and ffprobe are installed and available on the PATH. The scripts call these binaries via subprocess but the skill metadata does not declare them as requirements.
- Confirm the 'read' tool referenced in SKILL.md is available in your agent/runtime (it's an agent UI/tool to open images); otherwise adjust instructions to use an available image viewer.
- The SKILL.md and files use the name 'hair-cam-anno' while the registry slug is 'sjht-cam-anno' — ask the publisher or inspect provenance to ensure this package is legitimate and unmodified.
- The instructions mention processing '/root/hair-cam' (absolute path). Do not run the tool against system/root directories unless you intentionally want to process those files; point it at a controlled dataset directory instead.
- Privacy and legal: the tool is designed to generate detailed descriptions of people (age, appearance, actions). Ensure you have consent and legal authority to process and store CCTV footage and derived datasets; consider redacting or avoiding personally identifying attributes.
- Data handling: the build_jsonl script writes relative/declared paths into dataset.jsonl (it uses 'data/{video_name}' as image paths). Verify these paths meet your training pipeline expectations and that sensitive images are stored/handled securely.
- Run the scripts in an isolated environment (sandbox or container) when first testing. Inspect logs/output for unexpected behavior; nothing in the code performs network calls but testing in isolation reduces risk.
- If you require the skill to be deployable across different environments, update the metadata to declare required binaries and clarify the expected directory layout and the 'read' tool dependency.
If you want, I can: (1) point out the exact lines to change to declare binaries, (2) produce a minimal wrapper to validate ffmpeg presence before running, or (3) produce a safer system-prompt variant that avoids sensitive PII extraction.
Capability Analysis
Type: OpenClaw Skill
Name: sjht-cam-anno
Version: 1.0.0
The skill bundle is a legitimate tool for annotating security camera footage to create datasets for vision-language models. The Python scripts (extract_frames.py and build_jsonl.py) use standard libraries and system utilities like ffmpeg for video processing, with no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
Purpose & Capability
The skill's stated purpose (CCTV video annotation) matches the included scripts (frame extraction and JSONL builder). However, the SKILL.md and scripts rely on external binaries (ffmpeg/ffprobe) and an agent 'read' tool, but the registry metadata declares no required binaries or config paths. The SKILL.md also repeatedly references 'hair-cam' and an absolute path fragment '/root/hair-cam' while the package slug/name is sjht-cam-anno — this name/path mismatch and missing declared runtime dependencies are inconsistent with the stated purpose.
Instruction Scope
The runtime instructions stay within annotation scope: extract frames, inspect images, generate structured annotations, and build dataset.jsonl. They instruct the agent to use a 'read' tool to open frame images and to infer metadata from filenames. This is privacy-sensitive (detailed physical descriptions of people) but consistent with the tool's purpose. The instructions reference processing a specific path (e.g., /root/hair-cam) which could encourage scanning or operating on system/root directories — that should be clarified/limited.
Install Mechanism
There is no install spec (instruction-only plus two small scripts). That is low-risk from an installation code-fetch perspective. The included scripts are local and do not download or execute remote code.
Credentials
No environment variables, credentials, or config paths are requested. The scripts only access local files and spawn ffmpeg/ffprobe. This access is proportionate to the stated task. Note: lack of declared binaries (ffmpeg/ffprobe) is an omission but not a secret/credential overreach.
Persistence & Privilege
The skill does not request persistent/always-on privileges, does not modify other skills or global agent settings, and will only run when invoked. No autonomous always:true flag is set.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install sjht-cam-anno - After installation, invoke the skill by name or use
/sjht-cam-anno - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
# Changelog — hair-cam-anno
所有格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/),
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
---
## [0.1.0] — 2026-03-18
### 新增
- 初始版本发布
- **视频帧提取脚本** `scripts/extract_frames.py`
- 基于 ffmpeg,支持 mp4/avi/mkv/mov/flv/wmv/webm 格式
- 可配置提取帧率(默认 0.5 fps)和每视频最大帧数(默认 4 帧)
- 自动生成 `manifest.json`(含视频元信息:分辨率、时长、帧数、编码格式)
- **dataset.jsonl 构建脚本** `scripts/build_jsonl.py`
- 读取 `annotations.json`,生成符合 VL 模型微调规范的 `dataset.jsonl`
- 内置自动验证:字段完整性、标签合法性、风险等级合法性、simple_description 长度(≤20字)、description 长度(≥50字)
- **System Prompt 模板** `references/system-prompt.md`
- 定义 VL 模型角色、6 步分析流程、JSON 输出格式约束
- 包含 15 个预定义场景标签(system_suggest_0 ~ system_suggest_14)
- 风险等级:none / low / medium / high
- **标签与风险等级参考** `references/labels-reference.md`
- 15 个标签定义与含义说明
- 4 级风险等级定义及典型场景
- 数据集类别要求(物体/行为动作/环境)数量标准
- **SKILL.md** 技能主文件
- 三步工作流程:帧提取 → 逐视频分析标注 → 汇总生成 dataset.jsonl
- 标签选择规则指导
Metadata
Frequently Asked Questions
What is sjht-cam-anno?
安防摄像头视频 VL 模型微调数据集标注工具。用于从安防摄像头视频中提取关键帧、分析视频内容、生成结构化标注(含环境/人物/行为/风险描述),并输出符合 dataset.jsonl 格式的微调训练数据。Use when 用户需要对安防摄像头视频进行数据标注、生成 VL 模型训练数据集、处理 /root/hair-... It is an AI Agent Skill for Claude Code / OpenClaw, with 205 downloads so far.
How do I install sjht-cam-anno?
Run "/install sjht-cam-anno" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is sjht-cam-anno free?
Yes, sjht-cam-anno is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does sjht-cam-anno support?
sjht-cam-anno is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created sjht-cam-anno?
It is built and maintained by Aowind (@aowind); the current version is v1.0.0.
More Skills