helix4u/obs-scene-capture
skills/integrations/obs-scene-capture/SKILL.md
Use OBS as a generic screenshot API. List scenes, inspect scene sources, and capture still images from scenes or sources via obs-websocket.
$ install --global
skillsauthnpx skillsauth add helix4u/hermes-agent obs-scene-captureInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 7:46 AM264.0s3 files scanned
SKILL.md
- name:
- obs-scene-capture
- description:
- Use OBS as a generic screenshot API. List scenes, inspect scene sources, and capture still images from scenes or sources via obs-websocket.
- version:
- 1.1.0
- author:
- Hermes Agent
- license:
- MIT
- tags:
- [OBS, obs-websocket, Screenshot, Scene Capture, Source Capture, API]
OBS Scene Capture API
Use this skill to treat OBS like a local screenshot API for any scene or source you have configured.
What this gives you
- List all scenes currently available in OBS
- List sources inside a specific scene
- Capture PNG stills from a scene or source on demand
- Save captures to
TMP/obs/for downstream analysis or sharing
Prerequisites
- OBS is running
- OBS WebSocket server is enabled (default port
4455) - Python package
obsws-pythonis installed in the active environment
Install dependency:
pip install obsws-python
If a local venv exists, activate it first.
Quick start
List scenes:
python skills/integrations/obs-scene-capture/scripts/obs_still.py --list-scenes
List sources in a scene:
python skills/integrations/obs-scene-capture/scripts/obs_still.py --list-sources --scene "Main Monitor"
Capture a scene:
python skills/integrations/obs-scene-capture/scripts/obs_still.py --scene "Main Monitor" --output TMP/obs/main-monitor.png
Capture a source:
python skills/integrations/obs-scene-capture/scripts/obs_still.py --source "Browser Capture" --output TMP/obs/browser-capture.png
Optional explicit resolution:
python skills/integrations/obs-scene-capture/scripts/obs_still.py --scene "Main Monitor" --output TMP/obs/main-monitor-1440p.png --width 2560 --height 1440
Connection options
Defaults:
--host localhost--port 4455--password ""
Environment variable overrides:
OBS_HOSTOBS_PORTOBS_PASSWORD
API-oriented workflow
- Call
--list-scenesto discover valid scene names. - Call
--list-sources --scene "..."to inspect precise source names. - Capture the exact scene or source needed.
- Return the saved file path (for example,
TMP/obs/main-monitor.png) as an artifact for the next step in your flow.
Notes
- Scene and source names are exact-match and case-sensitive.
- Scenes are valid screenshot targets, so scene capture is a good default when source names are unknown.
- The script writes PNG files and handles UTF-8-safe paths.
More setup details
If OBS connection setup is the blocker, read references/obs-websocket.md.
Related Skills
helix4u/writing-plans
development
VerifiedTrustedCommunity
Use when you have a spec or requirements for a multi-step task. Creates comprehensive implementation plans with bite-sized tasks, exact file paths, and complete code examples.
4SKILL.mdUpdated Apr 18, 2026
helix4u/test-driven-development
development
VerifiedTrustedCommunity
Use when implementing any feature or bugfix, before writing implementation code. Enforces RED-GREEN-REFACTOR cycle with test-first approach.
4SKILL.mdUpdated Apr 18, 2026
helix4u/systematic-debugging
development
VerifiedTrustedCommunity
Use when encountering any bug, test failure, or unexpected behavior. 4-phase root cause investigation — NO fixes without understanding the problem first.
4SKILL.mdUpdated Apr 18, 2026
helix4u/subagent-driven-development
development
VerifiedTrustedCommunity
Use when executing implementation plans with independent tasks. Dispatches fresh delegate_task per task with two-stage review (spec compliance then code quality).
4SKILL.mdUpdated Apr 18, 2026