Troubleshooting

Symptom	Next step
Node version error	Switch to Node 24; do not patch installed dependencies.
Unknown skill command	Use the prepared CLI 0.1.10 after publication; use manual downloads meanwhile.
No compatible skill bundle	Check CLI/SDK compatibility; do not bypass the catalog or checksum.
Validation or missing field	Read the reported path and generated types; fix the project contract.
Picture rejected	Use a declared, channel-owned published asset and SDK Picture.
Login approved but channel rejected	Log in for the intended channel; sessions cannot cross channels.
Upload interrupted	Renew login if needed and rerun the same upload.
Preview differs from live	Inspect revision/language status; preview does not publish content.
Build or deployment failed	Read status and logs before choosing retry or retry-deployment.
Submission unavailable in preview	Expected: lead forms submit only in published mode.

Preserve complete failure output, CLI/runtime versions and the affected revision ID when requesting help. Redact credentials, protected preview links, signed upload URLs and personal lead data.

A checksum failure or malformed archive must leave existing skills intact. For a locally modified skill, compare your edits before choosing --force.