🇧🇷 Português  |  🇺🇸 English

powershell-windows-best-skill

Status: EXPERIMENTAL — Esta skill está em fase ativa de testes e refinamento. Use por sua conta e risco. Sempre valide os scripts gerados antes de executá-los em ambientes críticos ou de produção.

Uma skill unificada para programação PowerShell exclusivamente no Windows. Consolida múltiplas skills da comunidade em uma única referência opinativa e otimizada para automação Windows com PowerShell 7+.

---

O Que É Isso

SKILL.md é um arquivo de instruções (skill/contexto) que fornece a qualquer LLM conhecimento profundo e específico do Windows sobre PowerShell. Cobre regras de sintaxe, tratamento de erros, padrões de performance, endurecimento de segurança, gerenciamento de módulos, testes e mais — sem ruído multiplataforma.

A skill é agnóstica de ferramenta: funciona com qualquer LLM e qualquer harness/agent que suporte carregar arquivos de instrução, contexto ou regras (Claude Code, Cursor, OpenCode, Aider, Codex, Cline, Continue, Continue.dev, GitHub Copilot Chat, ou prompts manuais). O arquivo é apenas Markdown com regras claras.

---

Como Usar

1. Carregar a skill no seu harness

A forma de carregar depende do harness que você usa. Exemplos comuns:

• Claude Code / OpenCode / Cline: copie SKILL.md para o diretório de skills/contexto do seu harness, ou referencie-o diretamente a partir deste repositório
• Cursor / Continue / Continue.dev: cole o conteúdo no arquivo de regras do projeto (por exemplo, .cursorrules, .continuerc, rules.md) ou no system prompt
• Copilot Chat / ChatGPT / Gemini / qualquer chat LLM: anexe SKILL.md como contexto, cole seu conteúdo no prompt do sistema, ou faça upload do arquivo na conversa
• Aider / Codex CLI: passe o caminho do SKILL.md como arquivo de leitura/regra adicional

2. Invocar em uma conversa

Referencie o arquivo da skill na sua sessão:

@SKILL.md escreva um script que monitore o espaço em disco e envie um alerta

Ou peça ao modelo explicitamente:

Usando a skill powershell-windows, refatore este script para tratar erros corretamente

3. O que o modelo vai aplicar

Com a skill ativa, o LLM seguirá os padrões definidos no arquivo:

• Envolver cmdlets em parênteses ao usar operadores lógicos
• Usar apenas saída ASCII (sem emoji nos scripts)
• Verificar nulo antes de acessar propriedades
• Sempre especificar -Depth no ConvertTo-Json
• Usar List[T] em vez de $array += para coleções dinâmicas
• Preferir Join-Path para construção de caminhos
• Incluir #Requires, Set-StrictMode e $ErrorActionPreference em todo script
• Aplicar atributos de validação de entrada em todos os parâmetros

---

Arquivo da Skill

Arquivo	Descrição
SKILL.md	Skill unificada exclusiva para Windows (use esta) — agnóstica de LLM/harness

Skills de Origem

A skill unificada foi construída consolidando e filtrando as seguintes skills da comunidade.

Repositório	Escopo	Status
sickn33/antigravity-awesome-skills · skills.sh	Pitfalls do Windows e regras críticas de sintaxe	Mesclado
josiahsiegel/claude-plugin-marketplace · skills.sh	Skill mestra completa de PowerShell — sintaxe, segurança, módulos	Mesclado (partes multiplataforma removidas)
404kidwiz/claude-supercode-skills · skills.sh	Recursos do PS7+	Parcialmente mesclado (apenas partes relevantes ao Windows)

---

O Que Foi Removido das Skills de Origem

O seguinte conteúdo foi intencionalmente excluído da skill unificada:

• Caminhos de instalação Linux e macOS
• Detecção de plataforma $IsLinux, $IsMacOS
• Remoting via SSH (alternativa multiplataforma ao WinRM)
• Orientação de "testar em todas as plataformas"
• Padrões de integração com Bash/shell
• Configurações de matriz multiplataforma em CI/CD
• Padrões de manipulação de caminhos multiplataforma

---

Aviso

ESTA SKILL É FORNECIDA "NO ESTADO EM QUE SE ENCONTRA", SEM NENHUM TIPO DE GARANTIA.

- Scripts e padrões sugeridos por esta skill não foram validados
  em todos os ambientes, configurações ou versões do Windows.
- Sempre revise os scripts gerados antes de executá-los.
- Teste primeiro em um ambiente que não seja de produção.
- Nunca execute scripts não confiáveis com privilégios de administrador sem revisão.
- O autor não se responsabiliza por perda de dados, danos ao sistema
  ou qualquer outra consequência decorrente do uso desta skill.

Antes de executar qualquer script em ambiente crítico:

1. Leia o script inteiro e entenda o que ele faz
2. Execute Invoke-ScriptAnalyzer -Path script.ps1 e corrija todas as finding
3. Teste com -WhatIf quando suportado
4. Teste em um ambiente de staging ou isolado primeiro
5. Garanta que você tenha um plano de rollback (backup, snapshot, etc.)

---

Compatibilidade

Harness / LLM	Como usar
Claude Code, OpenCode, Cline	Carregue como skill/contexto ou @SKILL.md
Cursor, Continue, Continue.dev	Cole o conteúdo em .cursorrules / .continuerc / rules.md
Codex CLI, Aider	Passe como arquivo de regra adicional
Copilot Chat, ChatGPT, Gemini, qualquer chat	Anexe o arquivo, cole no prompt do sistema ou faça upload

A skill não depende de nenhuma API, plug-in ou runtime específico. É apenas Markdown.

---

Contribuindo

Encontrou um erro, padrão desatualizado ou conteúdo específico do Windows ausente? Abra uma issue ou envie um PR. Mantenha as contribuições exclusivas para Windows — conteúdo multiplataforma será rejeitado.