---
title: Troubleshooting
description: Diagnose common foundation and Expo verification failures.
---

# Troubleshooting

- Catalog drift: run `./Scripts/generate-skill-catalog.py` and inspect the manifest.
- Skill contract failure: check frontmatter, `Inputs:`, `Output:`, references, and TODOs.
- Installer conflict: preserve the existing file, directory, or external symlink; use the recorded state only for installer-owned links.
- `install-skills.sh --status` reports link divergence (missing, dangling, wrong-target, or stale): use the printed remediation command with the same `--target-dir` and `--tier`; if needed, uninstall that selected target, install again, and re-check status — see [Scripts: Status mode](/tools/scripts#status-mode). Use Git separately to inspect checkout content changes.
- Expo Doctor failure: reconcile the SDK and package versions before adding overrides.
- Native verification unavailable: report web/static checks and the remaining native risk.
- EAS prompt: stop for authorization, credentials, target, cost, and artifact policy.
