cross-platform-guardian

Cross-platform dotfiles require detecting hardcoded paths, platform-specific commands, and architecture mismatches, then validating across all target systems. This Skill audits your scripts, auto-fixes common issues, and tests your Nix flake across x86_64-linux, aarch64-linux, x86_64-darwin, and aarch64-darwin architectures using Docker and Nix.

Common issues include hardcoded paths, unguarded platform-specific commands, incorrect shebangs, non-standard XDG paths, and multi-architecture Nix flake definitions. Run the audit-compatibility.sh script to scan for these problems across macOS (Intel/ARM), Ubuntu, and Fedora.

Yes. This Skill provides test-platform-compatibility.sh to validate your Nix flake across all four architectures automatically, and keeps flake.lock in sync. It also verifies CI/Docker matrices for complete platform coverage.

The auto-fix workflow corrects command usage, adds platform guards where needed, and standardizes XDG paths. After running the audit, apply safe fixes automatically, then re-validate with the platform test script to confirm behavior consistency.

Yes. This Skill uses Nix flakes and Docker to test across all four architectures (x86_64-linux, aarch64-linux, x86_64-darwin, aarch64-darwin). You need both installed to run full validation workflows.

Run audits and tests when adding new scripts, updating flake.nix or flake.lock, investigating CI failures, or preparing changes for release. Regular checks catch compatibility drift early and prevent platform-specific regressions.