human-extractor

Extract human detections and crops from dashcam videos with YOLOv8 and ByteTrack.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/yousufjoyian/claude-skills --skill human-extractor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: human-extractor
Source: https://github.com/yousufjoyian/claude-skills/tree/main/human-extractor
Command: npx skills add https://github.com/yousufjoyian/claude-skills --skill human-extractor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the detection and extraction of human subjects from dashcam video footage, enabling rapid retrieval of evidence-ready crops and searchable metadata.

Core Features & Use Cases

  • GPU-accelerated: YOLOv8-based person detection with ByteTrack for stable IDs across frames.
  • Cropped outputs & indexing: saves cropped human images and builds per-date MANIFEST.csv and a global INDEX.csv for fast search.
  • Resume-safe: idempotent processing that skips already processed crops, allowing interruption and resumption.
  • Optional filtering: CLIP-based head-covering classification can be integrated in extended pipelines.
  • Use Case: process Park_R videos to extract all detected humans, generate per-date data, and enable cross-date searches.

Quick Start

Run the extraction workflow by providing a JSON config that points to source dashcam directories and an output folder. Example: create config.json from assets/config_template.json and run:

  • python scripts/run_extraction.py config.json
  • Or adapt the template to your environment and execute.

Frequently Asked Questions about human-extractor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract humans from dashcam video footage?

Extract humans from dashcam videos using YOLOv8 person detection paired with ByteTrack for stable tracking across frames. This Skill automates detection, crops detected humans, and generates searchable CSV indexes (per-date MANIFEST.csv and global INDEX.csv) for rapid evidence retrieval.

Can I process dashcam videos without manual frame-by-frame review?

Yes. This Skill GPU-accelerates the entire pipeline with YOLOv8 and ByteTrack, eliminating manual review. It outputs cropped human images and metadata indexes automatically, enabling fast search across your dashcam dataset.

What happens if my dashcam processing is interrupted?

Processing is idempotent and resume-safe. The Skill skips already-processed crops, so you can interrupt and restart without re-processing completed frames or losing progress.

How do I search and audit extracted humans across multiple dashcam files?

The Skill builds per-date MANIFEST.csv files and a global INDEX.csv that index all extracted humans. Query the index to retrieve crops and metadata across dates, enabling cross-file searches and audit trails.

Can I filter dashcam detections by specific attributes like head coverings?

Yes. The Skill supports optional CLIP-based head-covering classification in extended pipelines, allowing you to filter or label extracted humans by visual attributes beyond raw detection.

What input format and environment do I need for dashcam extraction?

Provide source dashcam video directories and an output folder configured in a JSON file (template in assets/config_template.json). A GPU is required for accelerated YOLOv8 detection and ByteTrack processing.