windows-compatibility

Standardize Windows-safe paths and Git workflows for cross-platform scripts.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/lbouriez/Squad-Templates --skill windows-compatibility-lbouriez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: windows-compatibility
Source: https://github.com/lbouriez/Squad-Templates/tree/main/Nectari-Devops-Squad/.copilot/skills/windows-compatibility
Command: npx skills add https://github.com/lbouriez/Squad-Templates --skill windows-compatibility-lbouriez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Squad runs on Windows, macOS, and Linux. Platform-specific assumptions have caused bugs when using Windows such as illegal characters in filenames, unreliable git -C usage, and inconsistent path separators.

Core Features & Use Cases

  • Standardize filenames, timestamps, and path construction to work reliably on Windows.
  • Enforce best practices for Git workflows (avoid git -C, cd first) and cross-platform scripting.
  • Provide practical guidance and utilities (like a safeTimestamp equivalent) to reduce platform fragility.

Quick Start

Apply Windows-safe path handling patterns in your build and automation processes to ensure cross-platform reliability.

Frequently Asked Questions about windows-compatibility

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

FAQPage Schema
Why does my Git workflow break on Windows but work on macOS and Linux?

Cross-platform Git workflows often break on Windows due to unreliable git -C usage and conflicting path conventions. Standardizing commands by changing into the repo root before execution ensures reliable cross-platform scripting and prevents Git errors.

How do I handle Windows path separators when writing cross-platform scripts?

To handle Windows path separators in cross-platform scripts, use path.join or path.resolve to construct file paths instead of manual string concatenation. This standardizes path handling and avoids illegal characters and separator mismatches.

What is the best way to generate file timestamps safely across different operating systems?

Generating safe file timestamps across operating systems requires using a standardized safeTimestamp equivalent. This avoids platform-specific timestamp formatting issues and ensures consistent file naming in cross-platform development.

Does using git -C cause reliability issues in Windows development environments?

Using git -C can cause reliability issues in Windows development environments due to path handling conflicts. Avoiding git -C and requiring a directory change into the repo root before running commands enforces safer cross-platform Git workflows.

What are the common limitations of Windows path handling in POSIX-based automation scripts?

Common limitations of Windows path handling in POSIX-based automation scripts include illegal filename characters and inconsistent path separators. Resolving these requires adopting cross-platform path construction utilities like path.resolve to reduce platform fragility.