george-blaze/srtc

SRTC — Grabación de Pantalla para Claude

SKILL_DIR es el directorio que contiene este SKILL.md (normalmente ~/.claude/skills/srtc). Todos los comandos siguientes se ejecutan desde ahí. La herramienta es python3 "$SKILL_DIR/vtc.py"; el motor de procesamiento es python3 "$SKILL_DIR/screencast/screencast.py".

Lo que hace

• ⌃⌘S activa/desactiva una grabación de pantalla + micrófono (agente en la barra de menú vtc-hotkey). Esc cancela. Límite de 10 minutos con un sonido de cuenta regresiva de 20 segundos y un panel rojo.
• Al detener: muestreo a 1 fps → fotogramas sin cambios eliminados → hojas de contacto de 2×2 con marcas de tiempo; registro del mouse → "hojas del puntero" con zoom para áreas rodeadas, en reposo o clicadas; Whisper (local, streaming durante la grabación) → transcripción con marcas de tiempo.
• Entrega: lleva a Claude al frente y pega las imágenes y luego el mensaje en el chat abierto (el usuario presiona Enter).
• Una regla en ~/.claude/CLAUDE.md (instalada desde claude-rule.md) hace que la narración sea la solicitud.

Comandos

Pregunta	Ejecuta
estado / está grabando	python3 "$SKILL_DIR/vtc.py" status
procesar una grabación existente (cualquier .mov/.mp4)	python3 "$SKILL_DIR/screencast/screencast.py" digest "<archivo>" → luego Lee el DIGEST.md impreso, luego cada hoja en sheets/ y pointer/
uso de almacenamiento	python3 "$SKILL_DIR/vtc.py" usage
limpiar tomas antiguas / limpiar todo	python3 "$SKILL_DIR/vtc.py" clean / python3 "$SKILL_DIR/vtc.py" clean --all
cambiar tecla rápida / mic / límite / retención	editar ~/.config/vtc.json (claves: hotkey, mic, cap_seconds, warn_seconds, keep_days, deliver, auto_send, asr), luego launchctl kickstart -k gui/$(id -u)/com.srtc.hotkey
instalar / reinstalar	"$SKILL_DIR/install.sh" (el usuario debe ejecutarlo: registra un agente de inicio de sesión y un certificado de llavero)

Cuando el usuario pregunta sobre una grabación que acaba de hacer, la carpeta del resumen es recordings/<fecha>.digest/ al lado del video (por defecto ~/Movies/SRTC/, o recordings en ~/.config/vtc.json): lee DIGEST.md primero, luego las hojas que enumera.

Solución de problemas (revisar en este orden)

1. Tecla rápida muerta, la barra de menú dice "tecla rápida bloqueada: campo de contraseña" → alguna aplicación mantiene la entrada de teclado segura (un campo de contraseña enfocado, a menudo un navegador). Sal de él. ioreg -l -w 0 | grep -o '"kCGSSessionSecureInputPID"=[0-9]*' muestra el pid.
2. Tecla rápida muerta, el registro dice "no confiable" (~/Library/Application Support/VideoToClaude/hotkey.log) → se perdió el permiso de Accesibilidad (sucede después de reconstruir sin sign.sh). Configuración del Sistema → Privacidad y Seguridad → Accesibilidad: elimina vtc-hotkey (−), agrégalo de nuevo (+ o arrastra el binario). El agente se activa en 2 s.
3. "No se grabó nada" → falta el permiso de Grabación de Pantalla o Micrófono para vtc-hotkey; Grabación de Pantalla solo se aplica después de launchctl kickstart -k gui/$(id -u)/com.srtc.hotkey.
4. Transcripción vacía o basura → verifica la línea "audio peak / average" del resumen; por debajo de −40 dB promedio significa que el micrófono es incorrecto. mic en ~/.config/vtc.json es una lista de prioridad; python3 "$SKILL_DIR/screencast/screencast.py" devices enumera los dispositivos.
5. Transcripción correcta pero tardía → falta el modelo Whisper (models/whisper-large-v3-turbo/weights.safetensors); consulta el README. Registros: ~/Library/Application Support/VideoToClaude/{hotkey,runner,asr,recorder-ffmpeg}.log.

Nunca ejecutes install.sh, sign.sh o launchctl bootstrap tú mismo; muestra el comando y deja que el usuario lo ejecute.