Skills
.Work. You
Rest

cross-platform-guardian

Community

Ensure dotfiles work across macOS and Linux.

Software Engineering#automation#testing#Docker#compatibility#dotfiles#cross-platform#Nix
Authorwcygan
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill ensures cross-platform compatibility for your dotfiles across macOS (Intel/ARM), Ubuntu, and Fedora by detecting hard-coded paths, platform-specific assumptions, and architecture gaps, then auto-fixing where possible and validating with Nix + Docker testing.

Core Features & Use Cases

  • Audit: Scans for hard-coded paths, missing guards, and platform-specific assumptions.
  • Auto-Fix: Applies safe fixes to command usage, guards, and config paths.
  • Test: Validates the Nix flake across all four architectures (x86_64-linux, aarch64-linux, x86_64-darwin, aarch64-darwin).
  • Update & CI: Keeps flake.lock in sync and checks CI/Docker matrices for full coverage.

Quick Start

Run the compatibility audit and platform tests:

  • ./.claude/skills/cross-platform-guardian/scripts/audit-compatibility.sh
  • ./.claude/skills/cross-platform-guardian/scripts/test-platform-compatibility.sh

Dependency Matrix

Required Modules

None required

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: cross-platform-guardian
Download link: https://github.com/wcygan/dotfiles/archive/main.zip#cross-platform-guardian

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.