PowerShell Windows Patterns

powershell-windows

PowerShell Windows patterns. Critical pitfalls, operator syntax, error

darthlinuxer/Agentic-Skills·0installs1stars

SKILL.md

Full skill instructions

PowerShell Windows Patterns

Critical patterns and pitfalls for Windows PowerShell.

1. Operator Syntax Rules

CRITICAL: Parentheses Required

❌ Wrong	✅ Correct
`if (Test-Path "a" -or Test-Path "b")`	`if ((Test-Path "a") -or (Test-Path "b"))`
`if (Get-Item $x -and $y -eq 5)`	`if ((Get-Item $x) -and ($y -eq 5))`

Rule: Each cmdlet call MUST be in parentheses when using logical operators.

2. Unicode/Emoji Restriction

CRITICAL: No Unicode in Scripts

Purpose	❌ Don't Use	✅ Use
Success	✅ ✓	[OK] [+]
Error	❌ ✗ 🔴	[!] [X]
Warning	⚠️ 🟡	[*] [WARN]
Info	ℹ️ 🔵	[i] [INFO]
Progress	⏳	[...]

Rule: Use ASCII characters only in PowerShell scripts.

3. Null Check Patterns

Always Check Before Access

❌ Wrong	✅ Correct
`$array.Count -gt 0`	`$array -and $array.Count -gt 0`
`$text.Length`	`if ($text) { $text.Length }`

4. String Interpolation

Complex Expressions

❌ Wrong	✅ Correct
`"Value: $($obj.prop.sub)"`	Store in variable first

Pattern:

$value = $obj.prop.sub
Write-Output "Value: $value"

5. Error Handling

ErrorActionPreference

Value	Use
Stop	Development (fail fast)
Continue	Production scripts
SilentlyContinue	When errors expected

Try/Catch Pattern

Don't return inside try block
Use finally for cleanup
Return after try/catch

6. File Paths

Windows Path Rules

Pattern	Use
Literal path	`C:\Users\User\file.txt`
Variable path	`Join-Path $env:USERPROFILE "file.txt"`
Relative	`Join-Path $ScriptDir "data"`

Rule: Use Join-Path for cross-platform safety.

7. Array Operations

Correct Patterns

Operation	Syntax
Empty array	`$array = @()`
Add item	`$array += $item`
ArrayList add	`$list.Add($item)

8. JSON Operations

CRITICAL: Depth Parameter

❌ Wrong	✅ Correct
`ConvertTo-Json`	`ConvertTo-Json -Depth 10`

Rule: Always specify -Depth for nested objects.

File Operations

Operation	Pattern
Read	`Get-Content "file.json" -Raw
Write	`$data

9. Common Errors

Error Message	Cause	Fix
"parameter 'or'"	Missing parentheses	Wrap cmdlets in ()
"Unexpected token"	Unicode character	Use ASCII only
"Cannot find property"	Null object	Check null first
"Cannot convert"	Type mismatch	Use .ToString()

10. Script Template


# Strict mode
Set-StrictMode -Version Latest
$ErrorActionPreference = "Continue"

# Paths
$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path

# Main
try {
    # Logic here
    Write-Output "[OK] Done"
    exit 0
}
catch {
    Write-Warning "Error: $_"
    exit 1
}

Remember: PowerShell has unique syntax rules. Parentheses, ASCII-only, and null checks are non-negotiable.

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/darthlinuxer/Agentic-Skills --skill powershell-windows

View on GitHub

.agent/skills/powershell-windows/SKILL.md

geo-fundamentals
Generative Engine Optimization for AI search engines (ChatGPT,
0 installs
senior-software-developer
Provides production-quality patterns, standards, and language-specific
0 installs
aesthetic
Create aesthetically beautiful interfaces following proven design principles.
0 installs
code-review-checklist
Code review guidelines covering code quality, security, and best practices.
0 installs

More skills from darthlinuxer

darthlinuxer/Agentic-Skills

brainstorming

Socratic questioning protocol + user communication. MANDATORY for complex

1 0

View

darthlinuxer/Agentic-Skills

app-builder

Main application building orchestrator. Creates full-stack applications

1 0

View

darthlinuxer/Agentic-Skills

frontend-development

Frontend development guidelines for React/TypeScript applications. Modern

1 0

View

darthlinuxer/Agentic-Skills

nodejs-best-practices

Node.js development principles and decision-making. Framework selection,

1 0

View

darthlinuxer/Agentic-Skills

game-design

Game design principles. GDD structure, balancing, player psychology,

1 0

View

darthlinuxer/Agentic-Skills

test-driven-development

Primary methodology for implementing features and bugfixes - enforces

1 0

View

darthlinuxer/Agentic-Skills

using-superpowers

Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

1 0

View

darthlinuxer/Agentic-Skills