windows-compatibility

Normalize Windows paths and enforce safe Git workflows in scripts.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/jperezdelreal/GymBro --skill windows-compatibility-jperezdelreal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: windows-compatibility
Source: https://github.com/jperezdelreal/GymBro/tree/main/.copilot/skills/windows-compatibility
Command: npx skills add https://github.com/jperezdelreal/GymBro --skill windows-compatibility-jperezdelreal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cross-platform path handling and command-pattern pitfalls cause Windows-specific bugs in scripts, tooling, and CI workflows.

Core Features & Use Cases

  • Prevent illegal Windows filenames by avoiding colons; provide safe timestamp formatting and path normalization.
  • Enforce reliable Git workflows by avoiding git -C and promoting explicit cd usage, along with standard path.join/path.resolve utilities.
  • Document constraints and best practices for cross-platform tooling in Node.js, Python, and shell scripts.

Quick Start

Integrate safe path utilities and Windows-friendly git workflows into your build and automation scripts.

Frequently Asked Questions about windows-compatibility

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

FAQPage Schema
How do I fix Windows path handling bugs in Node.js CI workflows?

Fix Windows path handling bugs in Node.js CI workflows by applying cross-platform path normalization and using path.join or path.resolve utilities to prevent path-related failures. This ensures scripts run reliably across different operating systems.

Why does git -C cause failures on Windows and what is the best alternative?

Git -C causes failures on Windows due to path handling inconsistencies, so the best alternative is enforcing explicit directory changes with cd before running git commands. This approach standardizes your Git workflow across platforms.

How do I prevent illegal Windows filenames when formatting timestamps in shell scripts?

Prevent illegal Windows filenames when formatting timestamps in shell scripts by avoiding colons in the format string and applying safe timestamp formatting. This stops invalid characters from breaking file generation on Windows environments.

Can I use this cross-platform tooling for Python and shell scripts too?

Yes, you can apply these cross-platform tooling constraints and best practices to Python and shell scripts as well. The Skill documents safe path normalization and command patterns for Node.js, Python, and shell environments.

What causes cross-platform command-pattern bugs in Windows build scripts?

Cross-platform command-pattern bugs in Windows build scripts are caused by inconsistent path delimiters, unsafe filename characters, and non-standard git commands. Applying cross-platform path normalization and explicit directory changes resolves these issues.