Troubleshooting imports

The file is rejected

Confirm that:

• The file is valid JSON.
• format is exactly skafold-context.
• version is exactly 1.0.
• project.name and project.summary are present.
• pages is an array.
• IDs are unique.
• References point to declared IDs.
• The file is below the import size limit.

Ask the installed AI skill to validate and return the complete corrected package.

A category did not create a node

Skafold omits empty optional categories. Inspect the JSON and confirm that the relevant field contains a non-empty value.

Design categories use fields such as colors, typography, layoutPrinciples, imageryGuidance, motionGuidance, uiTreatment, avoid, and designSystemNotes.

The structure has too many connections

Use parentId only for direct page hierarchy. Remove legacy leadsTo fields and represent detailed task flows as separate journeys.

A replacement removed project content

Replacement imports a complete package, not a patch. The AI must use the exported Skafold JSON as its baseline and retain supported fields that were not changed.

Recover from a previously exported JSON file, then repeat the revision with:

Return the complete revised package. Preserve all existing supported fields and IDs unless this request explicitly changes them.

Colors are missing

Each color requires a name and a six-digit hex value.

{
  "name": "--color-accent",
  "value": "#A44E2B"
}

Three-digit hex, RGB, HSL, and named CSS colors are not accepted by the current exchange contract.

You still need help

Include the validation message and a reduced example package when you contact support. Do not include secrets, credentials, private customer data, or production access tokens.