Habilidades powershell-windows
📦

powershell-windows

Seguro ⚙️ Comandos externos

Domine los patrones de scripting PowerShell para Windows

Evite los errores comunes de PowerShell que causan fallos en scripts. Aprenda sintaxis adecuada de operadores, manejo de errores y patrones específicos de Windows para automatización confiable.

Soporta: Claude Codex Code(CC)
📊 71 Adecuado
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "powershell-windows". Verificar si archivo existe o directorio existe

Resultado esperado:

Use: if ((Test-Path "file.txt") -or (Test-Path "folder")) - Cada cmdlet debe estar envuelto en paréntesis al usar operadores lógicos

Usando "powershell-windows". Obtener longitud de array de manera segura

Resultado esperado:

Use: if ($array -and $array.Count -gt 0) - Siempre verifique que el array exista antes de acceder a propiedades

Usando "powershell-windows". Convertir objeto anidado a JSON

Resultado esperado:

Use: $data | ConvertTo-Json -Depth 10 - Siempre especifique el parámetro de profundidad para objetos anidados para evitar truncamiento

Auditoría de seguridad

Seguro
v1 • 2/24/2026

Static analysis detected 34 patterns but all are false positives. The SKILL.md file is documentation only, containing PowerShell syntax examples and best practices. No executable code or security risks present. The skill is a reference guide for proper PowerShell scripting patterns on Windows.

1
Archivos escaneados
173
Líneas analizadas
1
hallazgos
1
Auditorías totales

Factores de riesgo

⚙️ Comandos externos (7)
SKILL.md:21-22 SKILL.md:50-51 SKILL.md:61-67 SKILL.md:95-97 SKILL.md:109-111 SKILL.md:121-130 SKILL.md:147-165
Auditado por: claude

Puntuación de calidad

38
Arquitectura
100
Mantenibilidad
85
Contenido
34
Comunidad
100
Seguridad
91
Cumplimiento de la especificación

Lo que puedes crear

Scripting para Ingeniero DevOps

Crear scripts confiables de automatización para Windows con manejo adecuado de errores y seguridad de null para pipelines de CI/CD

Referencia para Administrador de Sistemas

Referencia rápida para reglas de sintaxis de PowerShell y errores comunes al mantener scripts heredados

Recurso de Aprendizaje para Desarrolladores

Aprenda las mejores prácticas de PowerShell y evite errores comunes al agregar scripting de Windows a su conjunto de herramientas

Prueba estos prompts

Pregunta de Sintaxis Básica 
¿Cuál es la sintaxis correcta de PowerShell para verificar si un archivo existe O se cumple otra condición?
Patrón de Manejo de Errores 
Muéstrame el patrón adecuado de try-catch-finally para scripts de PowerShell que necesitan limpiar recursos
Verificación de Seguridad de Null 
¿Cómo verifico de manera segura si un array tiene elementos antes de acceder a su propiedad Count en PowerShell?
Operaciones con Archivos JSON 
¿Cuál es la forma correcta de leer y escribir archivos JSON en PowerShell con objetos anidados?

Mejores prácticas

  • Envuelva cada cmdlet en paréntesis al usar operadores lógicos como -or y -and
  • Siempre verifique null antes de acceder a propiedades o métodos de objetos
  • Use Join-Path para construir rutas de archivos en lugar de concatenación de strings
  • Establezca ErrorActionPreference apropiadamente para su entorno (Stop para desarrollo, Continue para producción)
  • Especifique el parámetro -Depth al convertir objetos anidados a JSON

Evitar

  • Usar caracteres unicode o emoji en scripts de PowerShell - use marcadores ASCII como [OK] en su lugar
  • Acceder a propiedades sin verificaciones de null - causará errores en tiempo de ejecución en valores null
  • Usar ConvertTo-Json sin parámetro -Depth - los objetos anidados se truncarán
  • Colocar sentencias return dentro de bloques try - use finally para limpieza y return después

Preguntas frecuentes

¿Por qué los operadores lógicos de PowerShell requieren paréntesis adicionales?
PowerShell analiza cmdlets y operadores de manera diferente a otros lenguajes. Cada llamada a cmdlet debe estar envuelta en paréntesis para que el analizador identifique correctamente dónde termina cada comando antes de aplicar el operador lógico.
¿Cuál es la forma más segura de manejar rutas de archivos en PowerShell?
Use Join-Path en lugar de concatenación de strings. Esto maneja los separadores de ruta correctamente en diferentes versiones de Windows y evita problemas con barras invertidas al final.
¿Por qué debo evitar caracteres unicode en scripts de PowerShell?
Los caracteres unicode pueden causar errores de análisis en sistemas con diferentes codificaciones. Usar marcadores ASCII como [OK], [WARN] o [ERROR] asegura compatibilidad en todos los entornos Windows.
¿Qué ErrorActionPreference debo usar en producción?
Use 'Continue' en producción para permitir que los scripts manejen errores de manera elegante. Use 'Stop' durante el desarrollo para detectar problemas temprano. Use 'SilentlyContinue' cuando los errores sean esperados y manejados.
¿Cómo convierto adecuadamente objetos anidados a JSON?
Siempre especifique el parámetro -Depth con ConvertTo-Json. La profundidad predeterminada es 2, lo que trunca objetos anidados. Use -Depth 10 o superior para estructuras profundamente anidadas.
¿Cuál es el patrón correcto para acceso seguro a arrays con null?
Verifique tanto el array como su conteo: if ($array -and $array.Count -gt 0). Esto previene errores cuando el array es null o está indefinido antes de acceder a la propiedad Count.

Detalles del desarrollador

Autor

sickn33

Licencia

MIT

Repositorio

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/powershell-windows

Ref.

main

Estructura de archivos

📄 SKILL.md