[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72TR2PBPWBPXV2MV286EBQG":3,"skill-same:01M72TR2PBPWBPXV2MV286EBQG":65},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":14,"repositoryHtmlUrl":37,"repositoryHomepageUrl":37,"ownerHtmlUrl":38,"ownerBlogUrl":6,"ownerDescription":39,"updatedAt":40,"install":41,"resources":54},"01M72TR2PBPWBPXV2MV286EBQG","screenshot-debug",null,"Debug errores visibles en pantalla tomando un screenshot completo y analizándolo con un modelo de visión (Qwen3.6-Plus via OpenCode Go).","iberi22\u002Fskills","iberi22","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F10615454?v=4","01M72SQ2NXAA3GW0FSH053A5ES","Brahyan Belalcazar","01M72SQ2PYCH0SSA1K61NGEHDV",0,"MIT","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fscreenshot-debug\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: screenshot-debug\ndescription: \"Debug errores visibles en pantalla tomando un screenshot completo y analizándolo con un modelo de visión (Qwen3.6-Plus via OpenCode Go).\"\nversion: 1.0.0\nauthor: Hermes Agent\ntags: [debug, screenshot, vision, grim, hyprland, wayland, opencode-go]\n---\n\n# Screenshot Debug — Depuración Visual con OpenCode Go\n\nUsa este skill cuando el usuario reporte errores visibles en pantalla — overlays de Hyprland, ventanas de error, notificaciones, waybar con errores, etc. Toma un screenshot completo y analízalo con el modelo **Qwen3.6-Plus** (visión) a través de OpenCode Go.\n\n## Requisitos\n\n- `grim` instalado (para capturar pantalla en Wayland)\n- `slurp` instalado (para seleccionar región, opcional)\n- WAYLAND_DISPLAY accesible (usar `WAYLAND_DISPLAY=wayland-1` si no está en PATH)\n\n## Paso 0: Verificar disponibilidad de modelo con visión\n\nANTES de tomar screenshot, verifica si el modelo activo soporta imágenes. El modelo se lista en el primer mensaje del turno (`Model: \u003Cname>`). Si NO soporta visión:\n\n- `delegate_task` con `toolsets=[\"vision\"]` puede funcionar si existe otro modelo con visión configurado\n- **Si delegate_task también falla** (ej. HTTP 404 desde OpenCode Go), NO hay modelo de visión disponible\n- SALTA inmediatamente al análisis programático (Paso 3 → Opción C) en lugar de intentar ver el screenshot\n\n## Procedimiento\n\n### Paso 1: Tomar Screenshot\n\nSiempre con las variables de entorno correctas para Wayland (el agente NO tiene `$WAYLAND_DISPLAY` por defecto):\n\n```bash\nWAYLAND_DISPLAY=wayland-1 XDG_RUNTIME_DIR=\u002Frun\u002Fuser\u002F1000 grim \u002Ftmp\u002Fscreenshot_debug.png\n```\n\nVerifica que el archivo se creó y su tamaño (generalmente 300-900KB):\n```bash\nls -la \u002Ftmp\u002Fscreenshot_debug.png\n```\n\nSi el terminal tiene PATH corrupto, usa `execute_code` con `subprocess` en vez de `terminal`.\n\n### Paso 2: Analizar con Visión\n\nUsa `vision_analyze` para examinar la imagen. Enfócate en la **parte superior** de la pantalla — ahí aparecen los overlays de Hyprland:\n\n```\nvision_analyze(\n  image_url=\"\u002Ftmp\u002Fscreenshot_debug.png\",\n  question=\"Describe TODOS los errores, warnings y notificaciones visibles en la pantalla. Enfócate en la PARTE SUPERIOR (overlays de Hyprland, notificaciones, waybar). ¿Qué mensajes de error específicos ves? ¿Hay una barra roja indicadora? ¿Cuántos errores se muestran?\"\n)\n```\n\n### Paso 3: Si `vision_analyze` falla porque el modelo activo no soporta imágenes\n\n#### Opción A ✅ RECOMENDADA: Usar `delegate_task` con herramientas de visión\n\nEsto funciona porque el subagente puede usar `vision_analyze` con su propio modelo:\n\n```\ndelegate_task(\n  goal=\"Analiza el screenshot en \u002Ftmp\u002Fscreenshot_debug.png y describe todos los errores visibles en la pantalla. Enfócate en la PARTE SUPERIOR (overlays de Hyprland, notificaciones, errores de barra). Describe coordenadas, texto exacto, colores.\",\n  context=\"El screenshot está en \u002Ftmp\u002Fscreenshot_debug.png (ruta absoluta). Tiene aprox 600KB. El sistema es NixOS con Hyprland. Busca específicamente errores de configuración de Hyprland, ventanas de error, notificaciones.\",\n  toolsets=[\"vision\",\"file\",\"terminal\"]\n)\n```\n\n**Nota**: El subagente con `toolsets=[\"vision\"]` puede usar `vision_analyze` internamente para examinar la imagen.\n\n#### Opción B: Cambiar modelo temporalmente (requiere modificar ~\u002F.hermes\u002Fconfig.yaml)\n\nNo intentes cambiar `~\u002F.hermes\u002Fconfig.yaml` durante la sesión — es frágil y puedes perder la conexión.\n\n#### Opción C ⚠️ Análisis programático sin visión (cuando A y B fallan)\n\nCuando NO hay ningún modelo de visión disponible (tanto `vision_analyze` como `delegate_task` con toolsets vision fallan):\n\n1. **Determinar geometría de la ventana via IPC** (Hyprland):\n   ```bash\n   # Para ventanas regulares (xdg-shell)\n   hyprctl clients -j | python3 -c \"import json,sys; [print(f'Class:{c.get(\\\"class\\\")} Size:{c.get(\\\"size\\\")} At:{c.get(\\\"at\\\")}') for c in json.load(sys.stdin) if 'eww' in c.get('class','').lower() or 'dashboard' in c.get('title','').lower()]\"\n   \n   # Para ventanas layer-shell (EWW dock mode), NO aparecen en hyprctl clients\n   # Usar eww directamente:\n   eww list-windows\n   eww state | grep -E \"width|height|geometry\"\n   ```\n\n2. **Verificar ancho\u002Fconstraints desde el código fuente**:\n   ```bash\n   # Buscar width constraints en window geometry\n   grep -n \"geometry\\|:width\\|:height\" ~\u002F.config\u002Feww\u002Feww.yuck\n   \n   # Buscar min-width, max-width, width en styles\n   grep -n \"min-width\\|max-width\\|width\" ~\u002F.config\u002Feww\u002Feww.yuck\n   \n   # Verificar SCSS por propiedades de overflow\n   grep -n \"max-width\\|max-height\\|overflow\" ~\u002F.config\u002Feww\u002Feww.scss\n   ```\n\n3. **Verificar dimensiones del screenshot** (solo validación básica de archivo):\n   ```bash\n   # Leer dimensiones PNG sin PIL (Python stdlib)\n   python3 -c \"import struct; f=open('\u002Ftmp\u002Fss.png','rb'); f.seek(16); w=struct.unpack('>I',f.read(4))[0]; h=struct.unpack('>I',f.read(4))[0]; print(f'{w}x{h}')\"\n   ```\n\n4. **Usar `eww debug` para inspeccionar la jerarquía de widgets**:\n   ```bash\n   eww debug | grep -E \"VarName|width|min_width|max_width\" | head -30\n   ```\n\n5. **Reportar al usuario que no se pudo obtener análisis visual** y pedir confirmación textual:\n   - Describe exactamente qué cambios hiciste\n   - Pregunta si el problema persiste\n   - Adjunta la ruta del screenshot para que el usuario lo vea manualmente\n\n### Paso 4: Debuggear según lo que se vea\n\n#### Overlay de Hyprland (más común)\nEl overlay cuenta TODOS los errores de parseo. Acción inmediata:\n\n```bash\n# 1. Encontrar la instancia de Hyprland\nHYPRLAND_INSTANCE_SIGNATURE=$(ls \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F)\n\n# 2. Buscar errores de config\ngrep -i \"no such option\\|does not exist\\|Invalid dispatcher\" \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F$HYPRLAND_INSTANCE_SIGNATURE\u002Fhyprland.log\n\n# 3. Contar errores reales vs ruido de inicio\necho \"ERR (config): $(grep -c 'ERR \\]:' \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F$HYPRLAND_INSTANCE_SIGNATURE\u002Fhyprland.log)\"\necho \"ERR (aquamarine\u002FDRM): $(grep -c 'ERR from aquamarine' \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F$HYPRLAND_INSTANCE_SIGNATURE\u002Fhyprland.log)\"\necho \"WARN: $(grep -c 'WARN' \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F$HYPRLAND_INSTANCE_SIGNATURE\u002Fhyprland.log)\"\n```\n\n#### Validar cada opción del config contra Hyprland en ejecución\n\n```bash\nfor opt in \"general:cursor_inactive_timeout\" \"decoration:drop_shadow\" \"decoration:shadow_range\" \"decoration:col.shadow\" \"misc:vfr\" \"misc:render_ahead_of_time\" \"misc:no_direct_scanout\"; do\n  echo -n \"$opt: \"\n  hyprctl getoption $opt 2>&1 | head -1\ndone\n```\n\n- `\"no such option\"` = **removida** — buscar reemplazo o eliminar\n- Devuelve un valor = **válida**\n\n#### Notificaciones de Dunst\n```bash\ncat ~\u002F.config\u002Fdunst\u002Fdunstrc 2>\u002Fdev\u002Fnull\ndunstctl history 2>\u002Fdev\u002Fnull | head -20\n```\n\n#### EWW Dashboard (SWAL)\n```bash\n# Reiniciar daemon EWW (si se mató)\npkill -9 eww 2>\u002Fdev\u002Fnull; rm -f \u002Frun\u002Fuser\u002F1000\u002Feww-server_*\nWAYLAND_DISPLAY=wayland-1 eww daemon; sleep 1; eww open dashboard\n\n# Verificar estado\neww list-windows\neww state | grep -E \"EWW_CPU|cal_widget|time \" | head -3\n```\n**Overflow fix:** window 360px + scroll `:hscroll false` + `:width 360` + inner box `style=\"width:340px;min-width:340px;\"`. NO max-width en GTK3 CSS. `margin:0 6px` removido de cards. `cal_widget` usa Pango markup con `#00FF88`. `deflisten media_info` para Now Playing.\n\n#### Waybar con errores\n```bash\njournalctl --user -u waybar --no-pager -n 50\n```\n\n#### Error de compilación NixOS\n```bash\nnixos-rebuild dry-build --flake \u002Fpath\u002Fto\u002Fflake#hostname 2>&1 | grep -iE \"error|fail|trace\"\n```\n\nPara errores de **opciones deprecadas de Hyprland 0.55.x**, ver `references\u002Fhyprland-version-migration.md` (incluye tabla completa de opciones antiguas → reemplazos, comandos de diagnóstico, y ejemplo before\u002Fafter).\n\n### Paso 5: Verificar y cerrar el ciclo\n\n1. **Aplicar fixes** en el source (swal-desktop\u002Fhypr\u002Fhyprland.conf)\n2. **Rebuild**: `nixos-rebuild switch --flake ...`\n3. **Recargar Hyprland**: `hyprctl reload`\n4. **Verificar** que no hayan nuevos errores:\n   ```bash\n   grep -c \"ERR \\]:\" \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F$SIGNATURE\u002Fhyprland.log\n   # Debe ser 0 para el período post-reload\n   ```\n5. **Captura post-fix** para confirmar visualmente:\n   ```bash\n   WAYLAND_DISPLAY=wayland-1 XDG_RUNTIME_DIR=\u002Frun\u002Fuser\u002F1000 grim \u002Ftmp\u002Fscreenshot_after_fix.png\n   ```\n\n### Paso 6: Si el overlay persiste después del reload\n\nEl Error Overlay de Hyprland se crea al **inicio de la sesión** y NO siempre se destruye con `hyprctl reload`. Si el overlay sigue visible aunque el log esté limpio:\n- Decirle al usuario que cierre sesión (`SUPER SHIFT + Q` → logout, o `hyprctl dispatch exit`)\n- O agregar `disable_error_popups = true` en `misc {}` para prevenirlo en el futuro\n\n## Pitfalls\n\n- **SIEMPRE verificar visualmente antes de reportar un fix**. Si no hay modelo de visión disponible, NO digas \"el problema está resuelto\" — en su lugar: (a) ejecuta el Paso 3 → Opción C (análisis programático), (b) espera confirmación textual del usuario. Reportar \"✅ arreglado\" sin verificación visual causa frustración.\n- `grim` falla con \"failed to create display\" → Necesitas `WAYLAND_DISPLAY=wayland-1` y `XDG_RUNTIME_DIR=\u002Frun\u002Fuser\u002F1000`\n- `slurp` para screenshot de región puede fallar si no hay monitor conectado\n- `vision_analyze` con modelos text-only va a fallar → Usar `delegate_task` con subagente que tenga modelo de visión\n- La API de OpenCode Go requiere API key para acceso directo → Siempre usar las herramientas de Hermes (vision_analyze, delegate_task) en lugar de curl directo\n- El screenshot puede ser grande (>500KB) → Reducir resolución o convertir a JPEG si es necesario:\n  ```bash\n  magick \u002Ftmp\u002Fscreenshot_debug.png -resize 50% \u002Ftmp\u002Fscreenshot_small.jpg\n  ```\n\n## Modelos con Visión en OpenCode Go\n\n| Modelo | Tipo | Bueno para |\n|--------|------|------------|\n| `qwen3.6-plus` | Visión general | Debug de UI, texto en pantalla |\n| `mimo-v2-omni` | Multimodal completo | Análisis general |\n| `glm-5.1` | Visión | Texto chino\u002Fespañol en pantalla |\n","# Screenshot Debug — Depuración Visual con OpenCode Go\n\nUsa este skill cuando el usuario reporte errores visibles en pantalla — overlays de Hyprland, ventanas de error, notificaciones, waybar con errores, etc. Toma un screenshot completo y analízalo con el modelo **Qwen3.6-Plus** (visión) a través de OpenCode Go.\n\n## Requisitos\n\n- `grim` instalado (para capturar pantalla en Wayland)\n- `slurp` instalado (para seleccionar región, opcional)\n- WAYLAND_DISPLAY accesible (usar `WAYLAND_DISPLAY=wayland-1` si no está en PATH)\n\n## Paso 0: Verificar disponibilidad de modelo con visión\n\nANTES de tomar screenshot, verifica si el modelo activo soporta imágenes. El modelo se lista en el primer mensaje del turno (`Model: \u003Cname>`). Si NO soporta visión:\n\n- `delegate_task` con `toolsets=[\"vision\"]` puede funcionar si existe otro modelo con visión configurado\n- **Si delegate_task también falla** (ej. HTTP 404 desde OpenCode Go), NO hay modelo de visión disponible\n- SALTA inmediatamente al análisis programático (Paso 3 → Opción C) en lugar de intentar ver el screenshot\n\n## Procedimiento\n\n### Paso 1: Tomar Screenshot\n\nSiempre con las variables de entorno correctas para Wayland (el agente NO tiene `$WAYLAND_DISPLAY` por defecto):\n\n```bash\nWAYLAND_DISPLAY=wayland-1 XDG_RUNTIME_DIR=\u002Frun\u002Fuser\u002F1000 grim \u002Ftmp\u002Fscreenshot_debug.png\n```\n\nVerifica que el archivo se creó y su tamaño (generalmente 300-900KB):\n```bash\nls -la \u002Ftmp\u002Fscreenshot_debug.png\n```\n\nSi el terminal tiene PATH corrupto, usa `execute_code` con `subprocess` en vez de `terminal`.\n\n### Paso 2: Analizar con Visión\n\nUsa `vision_analyze` para examinar la imagen. Enfócate en la **parte superior** de la pantalla — ahí aparecen los overlays de Hyprland:\n\n```\nvision_analyze(\n  image_url=\"\u002Ftmp\u002Fscreenshot_debug.png\",\n  question=\"Describe TODOS los errores, warnings y notificaciones visibles en la pantalla. Enfócate en la PARTE SUPERIOR (overlays de Hyprland, notificaciones, waybar). ¿Qué mensajes de error específicos ves? ¿Hay una barra roja indicadora? ¿Cuántos errores se muestran?\"\n)\n```\n\n### Paso 3: Si `vision_analyze` falla porque el modelo activo no soporta imágenes\n\n#### Opción A ✅ RECOMENDADA: Usar `delegate_task` con herramientas de visión\n\nEsto funciona porque el subagente puede usar `vision_analyze` con su propio modelo:\n\n```\ndelegate_task(\n  goal=\"Analiza el screenshot en \u002Ftmp\u002Fscreenshot_debug.png y describe todos los errores visibles en la pantalla. Enfócate en la PARTE SUPERIOR (overlays de Hyprland, notificaciones, errores de barra). Describe coordenadas, texto exacto, colores.\",\n  context=\"El screenshot está en \u002Ftmp\u002Fscreenshot_debug.png (ruta absoluta). Tiene aprox 600KB. El sistema es NixOS con Hyprland. Busca específicamente errores de configuración de Hyprland, ventanas de error, notificaciones.\",\n  toolsets=[\"vision\",\"file\",\"terminal\"]\n)\n```\n\n**Nota**: El subagente con `toolsets=[\"vision\"]` puede usar `vision_analyze` internamente para examinar la imagen.\n\n#### Opción B: Cambiar modelo temporalmente (requiere modificar ~\u002F.hermes\u002Fconfig.yaml)\n\nNo intentes cambiar `~\u002F.hermes\u002Fconfig.yaml` durante la sesión — es frágil y puedes perder la conexión.\n\n#### Opción C ⚠️ Análisis programático sin visión (cuando A y B fallan)\n\nCuando NO hay ningún modelo de visión disponible (tanto `vision_analyze` como `delegate_task` con toolsets vision fallan):\n\n1. **Determinar geometría de la ventana via IPC** (Hyprland):\n   ```bash\n   # Para ventanas regulares (xdg-shell)\n   hyprctl clients -j | python3 -c \"import json,sys; [print(f'Class:{c.get(\\\"class\\\")} Size:{c.get(\\\"size\\\")} At:{c.get(\\\"at\\\")}') for c in json.load(sys.stdin) if 'eww' in c.get('class','').lower() or 'dashboard' in c.get('title','').lower()]\"\n   \n   # Para ventanas layer-shell (EWW dock mode), NO aparecen en hyprctl clients\n   # Usar eww directamente:\n   eww list-windows\n   eww state | grep -E \"width|height|geometry\"\n   ```\n\n2. **Verificar ancho\u002Fconstraints desde el código fuente**:\n   ```bash\n   # Buscar width constraints en window geometry\n   grep -n \"geometry\\|:width\\|:height\" ~\u002F.config\u002Feww\u002Feww.yuck\n   \n   # Buscar min-width, max-width, width en styles\n   grep -n \"min-width\\|max-width\\|width\" ~\u002F.config\u002Feww\u002Feww.yuck\n   \n   # Verificar SCSS por propiedades de overflow\n   grep -n \"max-width\\|max-height\\|overflow\" ~\u002F.config\u002Feww\u002Feww.scss\n   ```\n\n3. **Verificar dimensiones del screenshot** (solo validación básica de archivo):\n   ```bash\n   # Leer dimensiones PNG sin PIL (Python stdlib)\n   python3 -c \"import struct; f=open('\u002Ftmp\u002Fss.png','rb'); f.seek(16); w=struct.unpack('>I',f.read(4))[0]; h=struct.unpack('>I',f.read(4))[0]; print(f'{w}x{h}')\"\n   ```\n\n4. **Usar `eww debug` para inspeccionar la jerarquía de widgets**:\n   ```bash\n   eww debug | grep -E \"VarName|width|min_width|max_width\" | head -30\n   ```\n\n5. **Reportar al usuario que no se pudo obtener análisis visual** y pedir confirmación textual:\n   - Describe exactamente qué cambios hiciste\n   - Pregunta si el problema persiste\n   - Adjunta la ruta del screenshot para que el usuario lo vea manualmente\n\n### Paso 4: Debuggear según lo que se vea\n\n#### Overlay de Hyprland (más común)\nEl overlay cuenta TODOS los errores de parseo. Acción inmediata:\n\n```bash\n# 1. Encontrar la instancia de Hyprland\nHYPRLAND_INSTANCE_SIGNATURE=$(ls \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F)\n\n# 2. Buscar errores de config\ngrep -i \"no such option\\|does not exist\\|Invalid dispatcher\" \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F$HYPRLAND_INSTANCE_SIGNATURE\u002Fhyprland.log\n\n# 3. Contar errores reales vs ruido de inicio\necho \"ERR (config): $(grep -c 'ERR \\]:' \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F$HYPRLAND_INSTANCE_SIGNATURE\u002Fhyprland.log)\"\necho \"ERR (aquamarine\u002FDRM): $(grep -c 'ERR from aquamarine' \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F$HYPRLAND_INSTANCE_SIGNATURE\u002Fhyprland.log)\"\necho \"WARN: $(grep -c 'WARN' \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F$HYPRLAND_INSTANCE_SIGNATURE\u002Fhyprland.log)\"\n```\n\n#### Validar cada opción del config contra Hyprland en ejecución\n\n```bash\nfor opt in \"general:cursor_inactive_timeout\" \"decoration:drop_shadow\" \"decoration:shadow_range\" \"decoration:col.shadow\" \"misc:vfr\" \"misc:render_ahead_of_time\" \"misc:no_direct_scanout\"; do\n  echo -n \"$opt: \"\n  hyprctl getoption $opt 2>&1 | head -1\ndone\n```\n\n- `\"no such option\"` = **removida** — buscar reemplazo o eliminar\n- Devuelve un valor = **válida**\n\n#### Notificaciones de Dunst\n```bash\ncat ~\u002F.config\u002Fdunst\u002Fdunstrc 2>\u002Fdev\u002Fnull\ndunstctl history 2>\u002Fdev\u002Fnull | head -20\n```\n\n#### EWW Dashboard (SWAL)\n```bash\n# Reiniciar daemon EWW (si se mató)\npkill -9 eww 2>\u002Fdev\u002Fnull; rm -f \u002Frun\u002Fuser\u002F1000\u002Feww-server_*\nWAYLAND_DISPLAY=wayland-1 eww daemon; sleep 1; eww open dashboard\n\n# Verificar estado\neww list-windows\neww state | grep -E \"EWW_CPU|cal_widget|time \" | head -3\n```\n**Overflow fix:** window 360px + scroll `:hscroll false` + `:width 360` + inner box `style=\"width:340px;min-width:340px;\"`. NO max-width en GTK3 CSS. `margin:0 6px` removido de cards. `cal_widget` usa Pango markup con `#00FF88`. `deflisten media_info` para Now Playing.\n\n#### Waybar con errores\n```bash\njournalctl --user -u waybar --no-pager -n 50\n```\n\n#### Error de compilación NixOS\n```bash\nnixos-rebuild dry-build --flake \u002Fpath\u002Fto\u002Fflake#hostname 2>&1 | grep -iE \"error|fail|trace\"\n```\n\nPara errores de **opciones deprecadas de Hyprland 0.55.x**, ver `references\u002Fhyprland-version-migration.md` (incluye tabla completa de opciones antiguas → reemplazos, comandos de diagnóstico, y ejemplo before\u002Fafter).\n\n### Paso 5: Verificar y cerrar el ciclo\n\n1. **Aplicar fixes** en el source (swal-desktop\u002Fhypr\u002Fhyprland.conf)\n2. **Rebuild**: `nixos-rebuild switch --flake ...`\n3. **Recargar Hyprland**: `hyprctl reload`\n4. **Verificar** que no hayan nuevos errores:\n   ```bash\n   grep -c \"ERR \\]:\" \u002Frun\u002Fuser\u002F1000\u002Fhypr\u002F$SIGNATURE\u002Fhyprland.log\n   # Debe ser 0 para el período post-reload\n   ```\n5. **Captura post-fix** para confirmar visualmente:\n   ```bash\n   WAYLAND_DISPLAY=wayland-1 XDG_RUNTIME_DIR=\u002Frun\u002Fuser\u002F1000 grim \u002Ftmp\u002Fscreenshot_after_fix.png\n   ```\n\n### Paso 6: Si el overlay persiste después del reload\n\nEl Error Overlay de Hyprland se crea al **inicio de la sesión** y NO siempre se destruye con `hyprctl reload`. Si el overlay sigue visible aunque el log esté limpio:\n- Decirle al usuario que cierre sesión (`SUPER SHIFT + Q` → logout, o `hyprctl dispatch exit`)\n- O agregar `disable_error_popups = true` en `misc {}` para prevenirlo en el futuro\n\n## Pitfalls\n\n- **SIEMPRE verificar visualmente antes de reportar un fix**. Si no hay modelo de visión disponible, NO digas \"el problema está resuelto\" — en su lugar: (a) ejecuta el Paso 3 → Opción C (análisis programático), (b) espera confirmación textual del usuario. Reportar \"✅ arreglado\" sin verificación visual causa frustración.\n- `grim` falla con \"failed to create display\" → Necesitas `WAYLAND_DISPLAY=wayland-1` y `XDG_RUNTIME_DIR=\u002Frun\u002Fuser\u002F1000`\n- `slurp` para screenshot de región puede fallar si no hay monitor conectado\n- `vision_analyze` con modelos text-only va a fallar → Usar `delegate_task` con subagente que tenga modelo de visión\n- La API de OpenCode Go requiere API key para acceso directo → Siempre usar las herramientas de Hermes (vision_analyze, delegate_task) en lugar de curl directo\n- El screenshot puede ser grande (>500KB) → Reducir resolución o convertir a JPEG si es necesario:\n  ```bash\n  magick \u002Ftmp\u002Fscreenshot_debug.png -resize 50% \u002Ftmp\u002Fscreenshot_small.jpg\n  ```\n\n## Modelos con Visión en OpenCode Go\n\n| Modelo | Tipo | Bueno para |\n|--------|------|------------|\n| `qwen3.6-plus` | Visión general | Debug de UI, texto en pantalla |\n| `mimo-v2-omni` | Multimodal completo | Análisis general |\n| `glm-5.1` | Visión | Texto chino\u002Fespañol en pantalla |\n",{"name":5,"tags":24,"author":32,"version":33,"description":7},[25,26,27,28,29,30,31],"debug","screenshot","vision","grim","hyprland","wayland","opencode-go","Hermes Agent","1.0.0","main","688810f2886d212632acf81e532b24e483dd8b98","skills\u002Fsoftware-development\u002Fscreenshot-debug","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills","https:\u002F\u002Fgithub.com\u002Fiberi22","Senior WEB Full-Stack","2026-10-12 02:46:21",{"source":8,"skillName":5,"commands":42,"prompt":52,"zipAvailable":53},[43,46,49],{"tool":44,"command":45},"npx","npx skills add iberi22\u002Fskills --skill screenshot-debug",{"tool":47,"command":48},"bunx","bunx skills add iberi22\u002Fskills --skill screenshot-debug",{"tool":50,"command":51},"pnpm","pnpm dlx skills add iberi22\u002Fskills --skill screenshot-debug","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fscreenshot-debug\u002FSKILL.md",true,[55,61],{"path":56,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Fhyprland-version-migration.md","REFERENCE","参考文档",3515,"https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fscreenshot-debug\u002Freferences\u002Fhyprland-version-migration.md",{"path":62,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fprogrammatic-analysis.md",2648,"https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fscreenshot-debug\u002Freferences\u002Fprogrammatic-analysis.md",[66,72,79,85,91,97],{"skillNo":67,"name":68,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M72TWQEQD46ZC9TRBAABF78P","web-design-guidelines","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fweb-design-guidelines\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M72TWMQFTYD08DGXVAXRPPEB","blocked-page-recovery","Use when a fetch fails: 403\u002F429, paywall, WAF, bot wall. Recovers the page via archives and provenance-checked fallbacks.","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fblocked-page-recovery\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M72TVQMS3HCTX18C8T97WTQQ","studio-coach","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftools\u002Fstudio-coach\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M72TVNA2PR9RZW0ZAXYP1G6J","src-generator","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftools\u002Fsrc-generator\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M72TVEJHHB6SAT3R3TY9MJKS","sqlite-pro","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftools\u002Fsqlite-pro\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M72TVC2EVBHQHCX96VTTYKB8","rigor-evaluator","Use when you need a quick heuristic rigor score (10 criteria, 0-2 each) for the features in a .gitcore\u002Ffeatures.json file, to decide which features are ready to ship.","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftools\u002Frigor-evaluator\u002FSKILL.md",[],[]]