xplat-checks

Cross-platform compatibility checking tools. Detects path issues, line endings, environment variables, shell commands, and other patterns that break on Windows or Linux.

⭐5stars🔀0forks📁View on GitHub🕐Updated Dec 27, 2025

When & Why to Use This Skill

This Claude skill provides a comprehensive suite of cross-platform compatibility checking tools designed to ensure Python codebases function seamlessly across Windows and Linux environments. By performing static analysis on paths, line endings, environment variables, and shell commands, it proactively identifies platform-specific dependencies that could lead to runtime failures or deployment issues.

Use Cases

  • Migrating legacy Python projects from Linux-only environments to cross-platform support by detecting hardcoded path separators and shell-specific commands.
  • Automating code quality audits during CI/CD pipelines to prevent the introduction of platform-specific environment variables like $HOME or %USERPROFILE%.
  • Resolving Git 'dirty tree' issues and execution errors caused by inconsistent CRLF/LF line endings in collaborative multi-OS development teams.
  • Identifying case-sensitivity bugs in file imports that work on Windows (case-insensitive) but fail on Linux (case-sensitive) production servers.
  • Refactoring code to use portable alternatives for temporary directory access and system-level operations instead of hardcoded paths like /tmp or C:\Temp.
namexplat-checks
descriptionCross-platform compatibility checking tools. Detects path issues, line endings, environment variables, shell commands, and other patterns that break on Windows or Linux.

Cross-Platform Checks Skill

Scripts for detecting cross-platform compatibility issues in Python code.

Scripts

check_paths.py

Detect hardcoded path separators.

python .claude/skills/xplat-checks/scripts/check_paths.py [directory]

Finds:

  • Hardcoded forward slashes in string paths
  • Hardcoded backslashes
  • Forward slashes inside os.path.join()

check_line_endings.py

Detect line ending issues.

python .claude/skills/xplat-checks/scripts/check_line_endings.py [directory]

Finds:

  • Files with CRLF line endings
  • Mixed line endings in single file
  • Missing .gitattributes

check_env_vars.py

Find platform-specific environment variable usage.

python .claude/skills/xplat-checks/scripts/check_env_vars.py [directory]

Finds:

  • $HOME, $USER (Unix-only)
  • %USERPROFILE%, %USERNAME%, %TEMP% (Windows-only)

check_case_sensitivity.py

Detect case sensitivity issues.

python .claude/skills/xplat-checks/scripts/check_case_sensitivity.py [directory]

Finds:

  • Files differing only by case
  • Import statements with wrong case

check_shell_commands.py

Detect shell command compatibility issues.

python .claude/skills/xplat-checks/scripts/check_shell_commands.py [directory]

Finds:

  • os.system() calls
  • subprocess with shell=True
  • Bash-specific commands

check_temp_paths.py

Find hardcoded temp directory paths.

python .claude/skills/xplat-checks/scripts/check_temp_paths.py [directory]

Finds:

  • /tmp references
  • C:\Temp references
  • /var/tmp references

Output Format

All scripts output JSON:

{
  "status": "PASS|FAIL",
  "files_scanned": 156,
  "issues": [
    {
      "file": "src/config.py",
      "line": 47,
      "column": 12,
      "issue": "Hardcoded forward slash in path",
      "code": "config_path = 'data/config.yaml'",
      "suggestion": "Use Path('data') / 'config.yaml'"
    }
  ]
}

Fix Reference

Issue Bad Good
Path separator "data/file.txt" Path("data") / "file.txt"
Home directory os.environ["HOME"] Path.home()
Temp directory "/tmp/file" Path(tempfile.gettempdir()) / "file"
Shell command os.system("rm -rf x") shutil.rmtree("x")
Username os.environ["USER"] getpass.getuser()