windows-compatibility

Normalize file paths and execute commands across Windows, macOS, and Linux.

413|64|Updated Feb 7, 2023
One-click install
npx skills add https://github.com/christianhelle/refitter --skill windows-compatibility-christianhelle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: windows-compatibility
Source: https://github.com/christianhelle/refitter/tree/main/.copilot/skills/windows-compatibility
Command: npx skills add https://github.com/christianhelle/refitter --skill windows-compatibility-christianhelle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Squad runs on Windows, macOS, and Linux. Several bugs have been traced to platform-specific assumptions: ISO timestamps with colons (illegal on Windows), git -C with Windows paths (unreliable), forward-slash paths in Node.js on Windows.

Core Features & Use Cases

  • Centralized path normalization utilities that convert and validate paths across platforms.
  • Safe, platform-aware command patterns that avoid shell-specific pitfalls and backslashes.
  • Real-world use cases include CI pipelines that run on Windows and macOS, and cross-platform scripts that manipulate files reliably.

Quick Start

Align your scripts to use safe path utilities that normalize separators and avoid platform-specific pitfalls.

Frequently Asked Questions about windows-compatibility

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I normalize file paths for cross-platform scripts running on Windows and macOS?

Cross-platform path normalization is achieved by converting and validating path separators across platforms. This approach provides centralized utilities that prevent forward-slash issues in Node.js and avoid backslash pitfalls on Windows.

Why does git -C fail with Windows paths in my CI pipeline?

Git -C fails with Windows paths due to unreliable handling of backslashes and platform-specific path formats. Using safe, platform-aware command patterns avoids these shell-specific pitfalls and ensures consistent execution across operating systems.

How do I handle ISO timestamps with colons in file names on Windows?

Handling ISO timestamps with colons on Windows requires avoiding illegal characters in file names. Safe file operation helpers centralize naming validation to prevent platform-specific errors when writing files across Windows, macOS, and Linux.

Can I use centralized path utilities for cross-platform CI pipelines?

Centralized path utilities are designed for cross-platform CI pipelines running on Windows, macOS, and Linux. They normalize path separators and validate file operations, ensuring scripts manipulate files reliably across different operating systems.

What is the best way to avoid shell-specific pitfalls in cross-platform command execution?

The best way to avoid shell-specific pitfalls in cross-platform command execution is using safe, platform-aware command patterns. These patterns replace Windows-specific backslashes and shell dependencies with normalized, reliable execution logic.