SharkByte561/windows-troubleshoot

Diagnostica y soluciona problemas de Windows 10/11 y Windows Server con el conjunto de herramientas de Microsoft TroubleShootingScript (TSS): asigna un síntoma al escenario y comando .\TSS.ps1 correcto, ejecuta un análisis de salud de solo lectura del equipo local (registros de eventos, fallos, pantallas azules, discos, servicios, actualizaciones, red, dominio) y analiza un archivo zip TSS / MS_DATA ya recopilado para obtener conclusiones en lenguaje natural.

¿Qué es windows-troubleshoot?

Esta habilidad convierte el conjunto de herramientas TSS (TroubleShootingScript) de Microsoft, que recopila datos exhaustivos pero no los interpreta, en un asistente de diagnóstico completo. Te permite identificar el escenario TSS correcto para cualquier síntoma de Windows (lentitud, pantallas azules, bloqueos de cuenta, problemas de red o impresión, fallos de actualización, etc.), ejecutar una revisión rápida de solo lectura del equipo (sin necesidad de permisos de administrador) que detecta problemas comunes como discos llenos, servicios detenidos o bloqueos, y analizar paquetes de datos ya recopilados (archivos zip de MS_DATA) para extraer hallazgos prácticos en lenguaje natural. Admite las plataformas Windows 10, 11 y Windows Server, y funciona tanto con PowerShell 5.1 integrado como con PowerShell 7. La habilidad incluye un catálogo completo de TSS, scripts de análisis y guías de referencia, todo diseñado para ahorrar horas de depuración manual. No modifica el sistema a menos que se le indique explícitamente, y sigue estrictas directrices de seguridad para evitar cambios no deseados.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SharkByte561/windows-troubleshoot/tree/HEAD/plugins/windows-troubleshoot/skills/windows-troubleshoot

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Solución de problemas de Windows con TSS

TSS es el conjunto de herramientas PowerShell firmado de Microsoft Support. Tiene 157 escenarios, alrededor de 400 componentes de seguimiento, 215 conjuntos de CollectLog, 9 informes SDP, 24 disparadores de parada automática y 34 comprobaciones de problemas conocidos de xray. Recopila datos muy bien, pero no explica casi nada de ellos. Esta habilidad proporciona las partes que faltan:

  • elegir qué recopilar;
  • comprobar de forma económica antes de recopilar nada;
  • leer lo que se ha obtenido.

La carpeta de la habilidad contiene un catálogo preconstruido de TSS (references/tss-index.json), por lo que las búsquedas funcionan incluso en máquinas sin TSS.

Ejecutar los scripts: las rutas son relativas a la carpeta de esta habilidad. Usa el PowerShell 5.1 integrado de Windows, que todas las máquinas Windows tienen: powershell -NoProfile -ExecutionPolicy RemoteSigned -File <script>. pwsh 7 funciona igual si está instalado.

  • -ExecutionPolicy RemoteSigned se aplica solo a ese proceso. Es necesario porque los clientes Windows tienen por defecto Restricted, que bloquea todos los archivos .ps1. Nunca uses Bypass (consulta references/safety.md).
  • Si un script sigue bloqueado porque la habilidad se descargó como un zip (

Skills relacionados