Agent skill

Cross Platform Guardian

by wcygan in wcygan/dotfiles

Protect macOS, Ubuntu, Fedora, and Linux/WSL compatibility in this dotfiles repository.

No licenceAuto-check passedTesting & QA

Install Cross Platform Guardian

skills CLI
$ npx skills add wcygan/dotfiles --skill cross-platform-guardian -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wcygan/dotfiles cross-platform-guardian --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wcygan/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/cross-platform-guardian .claude/skills/cross-platform-guardian && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cross-platform-guardian
GitHub stars
194
Token cost
~514 tokens
SKILL.md length
239 words
Files
5 (incl. scripts)
Skills in repo
19
Repo updated
First seen
Licence
None found

At a glance

Protect macOS, Ubuntu, Fedora, and Linux/WSL compatibility in this dotfiles repository.

  • Works in 5 steps: Inspect bootstrap.sh, the affected… → Check macOS and Linux/WSL behavior… → Resolve HOME, XDG, CODEX, and platform… → …
  • Portability reviews
  • SKILL.md covers Outcome, Current Setup Boundary, Review Workflow and Stop Conditions
  • Runs Shell scripts from its folder; calls make and nix

What it does

Cross Platform Guardian is an agent skill from wcygan/dotfiles. Protect macOS, Ubuntu, Fedora, and Linux/WSL compatibility in this dotfiles repository. Use for portability reviews, Nix changes, bootstrap changes, and platform test failures.

Its SKILL.md is about 510 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `README.md`, `REFERENCE.md` and `scripts/audit-compatibility.sh`).

It sits in Testing & QA, covering Failing and flaky tests. It works with Linux, macOS and Python. The repository describes itself as: Configuration for Development Environments.

When your agent uses it

  • Portability reviews
  • Bootstrap changes
  • Platform test failures

Example prompts

  • “/cross-platform-guardian”

Requirements

  • Python 3
  • A Bash shell
  • Docker

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Inspect bootstrap.sh, the affected Python module, flake.nix, and the
  2. Check macOS and Linux/WSL behavior separately. Preserve the macOS package
  3. Resolve HOME, XDG, CODEX, and platform paths through paths.py. Keep the
  4. Run make test-pre, then the focused suite: make test-local for links,
  5. Report platform evidence, skipped checks, and the rollback path. Nix package

What it can do on your machine

Read from SKILL.md and the folder at commit b385ffa. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • make
    • nix

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cross Platform Guardian loads about 514 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 239 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~514

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 239 words (~514 tokens).

“Keep the setup path reproducible across macOS, Ubuntu, Fedora, and Linux/WSL without hard-coded machine paths or untested platform assumptions.”

— opening of SKILL.md by wcygan
name
cross-platform-guardian

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (scripts) in .agents/skills/cross-platform-guardian of wcygan/dotfiles.

  • SKILL.md
  • README.md
  • REFERENCE.md
  • scripts/audit-compatibility.sh
  • scripts/test-platform-compatibility.sh

Open the folder on GitHubat commit b385ffa

Compare with similar skills

Cross Platform Guardian next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cross Platform Guardian compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cross Platform Guardian this skillwcygan/dotfiles194—~514Automated safety check: PassNone
Apple Container Test RunnerRustPython/RustPython22k—~467Automated safety check: PassMIT
Cross Platform Pathsmicrosoft/vscode-python-environments141—~1.5kAutomated safety check: PassMIT
Remote Hostslibnativeapi/nativeapi164—~1.3kAutomated safety check: PassMIT
Crossreviewcoddy-project/coddy-agent168—~3.3kAutomated safety check: PassMIT
Flutter UI Probelibnativeapi/nativeapi164—~988Automated safety check: PassMIT

Similar skills

  • Apple Container Test Runner

    RustPython/RustPython

    Runs RustPython tests inside a Linux container built with Apple's container CLI, so macOS users can compare Linux results with their local ones.

    22k GitHub stars~467 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Cross Platform Paths

    microsoft/vscode-python-environments

    Official

    Critical patterns for cross-platform path handling in this VS Code extension.

    141 GitHub stars~1.5k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Remote Hosts

    libnativeapi/nativeapi

    Build, run, and GUI-test on another machine over SSH — the user's Windows laptop today, Linux or other macOS machines tomorrow — with one symmetric CLI for every OS: push scripts, run them either in…

    164 GitHub stars~1.3k tokensUpdated yesterday
    MobileAuto-check passed
  • Crossreview

    coddy-project/coddy-agent

    Run when the user invokes /crossreview (or /crossreview:setup to choose the reviewers) or asks for a cross-review, a quorum review or a second opinion from other agents or models: fan a code review…

    168 GitHub stars~3.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Flutter UI Probe

    libnativeapi/nativeapi

    Find where widgets are on screen in a running debug Flutter desktop app (macOS, Windows, Linux) by reading its render tree through the VM service — no hard-coded coordinates, no screenshots, works…

    164 GitHub stars~988 tokensUpdated yesterday
    MobileAuto-check passed
  • Google Coral Edge TPU — real-time object detection natively (macOS / Linux)

    3.1k GitHub stars~1.2k tokensUpdated 24 days ago
    AI & LLM EngineeringAuto-check passed

More from wcygan/dotfiles

All 19 skills in this repo
  • Fish Shell Config

    wcygan/dotfiles

    Expert Fish shell configuration including config files, functions, abbreviations, prompts, environment variables, and scripting.

    194 GitHub stars~2.9k tokensUpdated 2 days ago
    Auto-check passed
  • Lazygit Config

    wcygan/dotfiles

    Configure lazygit TUI including config.yml setup, custom pagers (especially delta integration), themes, keybindings, and custom commands.

    194 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Nix Manager

    wcygan/dotfiles

    Manage Nix package, profile, flake, and diagnostic work in this dotfiles repository.

    194 GitHub stars~1k tokensUpdated 2 days ago
    Auto-check passed
  • Nvim Config

    wcygan/dotfiles

    Configure Neovim editor with init.lua, plugin management, LSP setup, keymaps, and options.

    194 GitHub stars~4.4k tokensUpdated 2 days ago
    Auto-check passed
  • Starship Config

    wcygan/dotfiles

    Configure and optimize Starship cross-shell prompt with presets, custom modules, and performance tuning.

    194 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Dotfiles Operations

    wcygan/dotfiles

    Operate, maintain, upgrade, troubleshoot, and review this dotfiles repository.

    194 GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Cross Platform Guardian

What does Cross Platform Guardian do?

Protect macOS, Ubuntu, Fedora, and Linux/WSL compatibility in this dotfiles repository. Cross Platform Guardian is an agent skill from wcygan/dotfiles. Protect macOS, Ubuntu, Fedora, and Linux/WSL compatibility in this dotfiles repository.

When should I use Cross Platform Guardian?

Cross Platform Guardian fits situations like: portability reviews; bootstrap changes; platform test failures.

How do I install Cross Platform Guardian in Claude Code?

Run `npx skills add wcygan/dotfiles --skill cross-platform-guardian -a claude-code`. Or copy the skill folder (.agents/skills/cross-platform-guardian in wcygan/dotfiles) into .claude/skills/cross-platform-guardian in your project. Claude Code loads it when a task matches its description.

How do I install Cross Platform Guardian in Codex?

Run `npx skills add wcygan/dotfiles --skill cross-platform-guardian -a codex`. Or copy the skill folder (.agents/skills/cross-platform-guardian in wcygan/dotfiles) into .agents/skills/cross-platform-guardian in your project. Codex loads it when a task matches its description.

Can I use Cross Platform Guardian in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wcygan/dotfiles --skill cross-platform-guardian -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cross-platform-guardian, .gemini/skills/cross-platform-guardian, .github/skills/cross-platform-guardian and .opencode/skills/cross-platform-guardian in your project.

What does Cross Platform Guardian need to run?

Going by SKILL.md and its folder, Cross Platform Guardian needs a shell for the scripts in its folder and the command-line tools its instructions call (make and nix). Our summary lists: Python 3; A Bash shell; Docker.

Does Cross Platform Guardian access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cross Platform Guardian safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Cross Platform Guardian use?

No licence was found for Cross Platform Guardian or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Cross Platform Guardian use?

About 514 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cross Platform Guardian?

Skills that share tags, products or a category with Cross Platform Guardian: Apple Container Test Runner (RustPython/RustPython, 22k stars), Cross Platform Paths (microsoft/vscode-python-environments, 141 stars), Remote Hosts (libnativeapi/nativeapi, 164 stars) and Crossreview (coddy-project/coddy-agent, 168 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cross Platform Guardian?

wcygan (a GitHub user) maintains it in wcygan/dotfiles, which has 194 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 8, 2026.

Source: wcygan/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.