Skafold Documentation

Working With AI

Import AI context

Create a Skafold project from AI-generated JSON or replace an existing project with a revised package.

Skafold imports a complete skafold-context JSON package. Generate the file with the Skafold AI skill or another process that follows the exchange schema.

Create a new project

  1. Open the Skafold dashboard.
  2. Choose the AI context import action.
  3. Select the generated .json file.
  4. Review validation errors or warnings.
  5. Confirm the import.

Skafold creates editable nodes for project context, page hierarchy, user journeys, page sections, architecture, and design guidance.

Replace an existing project

Use replacement when an AI has revised JSON exported from the current project.

  1. Open the project in Structure Studio.
  2. Open the context menu and choose Import JSON and replace.
  3. Select the complete revised package.
  4. Review the replacement warning and validation result.
  5. Confirm the replacement.

Replacement overwrites the current structure draft. Export the current JSON first when you need a recovery copy.

Validation warnings

A warning does not always block import. For example, Skafold may warn that a page has no sections. Errors must be corrected before import and usually identify an invalid field, duplicate ID, or missing reference.

Expected design nodes

Each populated design category imports as its own node:

  • Direction
  • Colors
  • Reference
  • Typography
  • Layout
  • Imagery
  • Motion
  • UI Treatment
  • Avoid
  • Design System

Empty categories are omitted.