Troubleshooting

Diagnose common foundation and Expo verification failures.

• 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. 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.