• Relative paths: relative(platform_skills_dir, canonical_skill_dir) for portability.
  • Idempotent: existing link pointing to the same target → skipped.
  • Update: existing link pointing to a different target → deleted and recreated.
  • Auto-create parents: mkdir -p ensures platform skills subdirectories exist.
  • Cross-platform: Windows uses junctions, Unix uses symlinks.