convert-skill-windows

name	convert-skill-windows
description	Convert Unix/Linux-based skill.md files to {{os}} equivalents. Use when you need to transform a skill that contains Unix/Linux-specific commands, paths, and tools into a version that works on {{os}}. Takes a file path to an input skill.md and outputs a converted _{{os}}.md version.

{{os}} Skill Converter

Convert Unix/Linux-based skill.md files to {{os}} equivalents by replacing OS-specific semantics with PowerShell/cmd.exe commands.

Input

• Required: File path to the source skill.md file
• Output: New file with _{{os}}.md appended to the original filename (e.g., SKILL.md → SKILL_{{os}}.md)

Conversion Rules

Path Conversions

Unix/Linux	{{os}}
/home/user/	C:\Users\user\
/usr/local/bin/	C:\Program Files\ or C:\Program Files (x86)\
~/	%USERPROFILE% or C:\Users\username\
~/.config/	%APPDATA%
/tmp/	%TEMP%
/path/to/file	C:\path\to\file

Command Conversions

Unix/Linux	{{os}} PowerShell	{{os}} cmd.exe
chmod +x script	Not needed (executables don't need +x)	Not needed
mkdir -p dir/subdir	New-Item -ItemType Directory -Path dir\subdir -Force	mkdir dir\subdir
ls, ls -la	Get-ChildItem or dir	dir
cat file	Get-Content file	type file
cp src dest	Copy-Item src dest	copy src dest
mv src dest	Move-Item src dest	move src dest
rm -rf dir	Remove-Item -Recurse -Force dir	rmdir /s /q dir
rm file	Remove-Item file	del file
touch file	New-Item -ItemType File file	echo. > file
curl -fsSL url -o file	Invoke-WebRequest -Uri url -OutFile file	curl -o file url
wget url -O file	Invoke-WebRequest -Uri url -OutFile file	curl -O url
echo "text" > file	"text" | Out-File file	echo text > file
echo "text" >> file	"text" | Out-File file -Append	echo text >> file
./script.sh	.\script.ps1 or .\script.bat	script.bat
bash -c "command"	powershell -Command "command"	cmd /c "command"
export VAR=value	$env:VAR="value"	set VAR=value
source file	. file (dot sourcing)	call file
which command	Get-Command command -ErrorAction SilentlyContinue	where command
grep	Select-String	findstr
find . -name "*.ext"	Get-ChildItem -Recurse -Filter "*.ext"	dir /s /b *.ext
tar -xvf file.tar.gz	Expand-Archive file.tar.gz -DestinationPath .	Use 7-Zip or WinRAR
zip -r file.zip dir	Compress-Archive -Path dir -DestinationPath file.zip	Use 7-Zip or WinRAR
unzip file.zip	Expand-Archive file.zip -DestinationPath .	Use 7-Zip or WinRAR
pip install package	pip install package (works in PowerShell)	pip install package
npm install	npm install (works in PowerShell)	npm install
apt-get install pkg	winget install pkg or download installer	N/A
yum install pkg	winget install pkg or download installer	N/A

Permission Commands

Unix/Linux	{{os}}
chmod 755 file	icacls file /grant Users:F
chmod +x file	Not applicable (use file extension or execution policy)
chown user:group file	icacls file /grant user:F

Environment Variables

Unix/Linux	{{os}} PowerShell	{{os}} cmd
$VAR	$env:VAR	%VAR%
${VAR}	$env:VAR	%VAR%
$HOME	$env:USERPROFILE	%USERPROFILE%
$PATH	$env:PATH	%PATH%
export PATH=$PATH:/new/path	$env:PATH += ";C:\new\path"	set PATH=%PATH%;C:\new\path

Common Tool Alternatives

Unix/Linux Tool	{{os}} Alternative
curl	Invoke-WebRequest (PowerShell), curl.exe ({{os}})
wget	Invoke-WebRequest (PowerShell)
git	git (works on {{os}})
python	python or py
node	node (works on {{os}})
nano	notepad, code, or VS Code
vim	vim, code, or VS Code
grep	Select-String (PowerShell), findstr (cmd)
sed	Use PowerShell regex or download sed for {{os}}
awk	Use PowerShell or download gawk for {{os}}

Usage

1. Read the input skill.md file
2. Apply path conversions (convert Unix paths to {{os}} paths)
3. Replace code blocks with {{os}} equivalents
4. Preserve all markdown structure, comments, and non-OS-specific content
5. Save the output as {original_name}_{{os}}.md in the same directory

Example Conversions

Before (Unix)

# Install the tool
curl -fsSL https://example.com/tool.sh -o /usr/local/bin/tool
chmod +x /usr/local/bin/tool

# Configure
mkdir -p ~/.config/tool
echo "api-key" > ~/.config/tool/config

# Run
tool --version

After ({{os}})

# Install the tool
Invoke-WebRequest -Uri "https://example.com/tool.ps1" -OutFile "C:\Program Files\tool\tool.ps1"

# Configure
New-Item -ItemType Directory -Path "$env:APPDATA\tool" -Force
"api-key" | Out-File "$env:APPDATA\tool\config"

# Run
& "C:\Program Files\tool\tool.ps1" -Version

Before (Unix)

export API_KEY="your-key-here"
./solve-captcha balance

After ({{os}})

$env:API_KEY = "your-key-here"
.\solve-captcha balance

Notes

• Always preserve the original file structure and markdown formatting
• Only convert code blocks (bash, shell, ```sh) that contain OS-specific commands
• Keep explanatory text and non-code content unchanged
• Use PowerShell as the primary conversion target (most modern {{os}})
• For backward compatibility, cmd.exe alternatives are also provided
• Some Linux tools have {{os}} ports (git, node, python, etc.) and don't need conversion