Skip to main content
PROMPT SPACE
A
Freedeveloper-toolsUniversal

agent-portability-checker

Audit and auto-fix agent skills to remove platform lock-in and ensure cross-platform compatibility.

skill install https://www.promptspace.in/skills/agent-portability-checker

What it does

The Agent Portability Checker is a developer tool designed to audit agent skills for platform lock-in. It scans your codebase for hardcoded paths, platform-specific dependencies, and rigid environmental assumptions that prevent your skills from running across different agent environments like Claude Code, OpenClaw, or Codex.

Why use this skill

Building skills that only work on one platform limits your reach and creates technical debt. This skill automates the tedious process of finding and fixing "platform leaks." It's significantly more reliable than manual prompting because it follows a rigorous 8-point checklist—including XDG fallback standards and headless OAuth compliance—that generic AI models often overlook.

Supported tools

  • Standard Python-based agent skills
  • XDG Base Directory Specification compliance
  • Cross-platform path resolution (os.path/pathlib)
  • Multi-channel formatting (Slack, Discord, WhatsApp)

What the output looks like

The skill provides a structured audit report flagging specific line numbers for hardcoded paths, missing environment variable support, and platform-specific CLI dependencies. When in 'fix' mode, it automatically refactors paths to use dynamic environment variables like $SKILL_DATA_DIR.

Use cases

  • Detect and fix hardcoded platform-specific file paths
  • Add XDG-compliant fallback paths for configuration storage
  • Strip platform-identifying strings from HTTP User-Agent headers
  • Develop skills for use in any agent

Example

Prompt

Audit this skill for platform lock-in and auto-fix any hardcoded paths.

Output

AUDIT REPORT: github-growth-tracker
❌ scripts/tracker.py:28: Hardcoded ~/.clawhub/ path found.
✅ Auto-fixed: Replaced with $SKILL_DATA_DIR.
⚠️ Warning: Script uses 'gh' CLI; ensure target agent has GitHub CLI installed.
🔧 XDG Fallback: Added ~/.config/tracker/ support.

Frequently asked questions

This tool scans your agent's source code for hardcoded paths and platform-specific dependencies that cause failure when moving between environments. It provides a detailed audit report and an optional 'fix' mode to automatically refactor your code for cross-platform compatibility.