Skafold Documentation

Support

Troubleshooting saves and AI imports

Get help with saving your work, importing AI plans, and keeping AI Context up to date.

One team member keeps getting a save conflict

Your browser may be holding an older, unsaved copy of the project. This can sometimes happen when another person updates the project while you have it open.

  1. Keep a copy of your unsaved work. Copy any recent text or notes somewhere safe before closing the project.
  2. Return to Projects and close any other tabs showing this project. If you cannot leave the editor, close the tab after copying your unsaved work.
  3. Try a private or incognito window. Sign in to Skafold and open the same project. Make a small edit and check that the toolbar shows Saved, then undo the edit and wait for Saved again.
  4. If saving works there, contact support. We can help clear the old pending save from your usual browser for this project only.

Clearing an old pending save discards unsaved changes in that browser. It does not remove the project's saved frames or your teammates' saved work. Leave the project closed during the reset so the browser cannot recreate the old draft.

Clearing your browser's cache alone may not clear a pending save. You do not need to delete the project or its history.

If saving still fails, contact support with the project name, the message shown on screen, and what you were doing when it happened.

A new-project file is rejected

Confirm that:

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

Ask Skafold Project Importer to run its validator and return one corrected seed.

An existing-project file is rejected

Existing projects require skafold-frame-update, not a project seed or legacy skafold-context package.

The file must use the protocol version accepted by the AI Context snapshot and include at least one supported frame. Every target needs mode: "replace", the current frame hash, and complete frame data.

Skafold says a target is stale

Another saved change affected a frame after the AI generated the update. Skafold blocks the older file to protect current work.

  1. Wait for Saved.
  2. Choose Update AI Context.
  3. Ask the AI to refetch the same URL.
  4. Regenerate the complete update file.

Do not manually replace the target hash.

AI Context says updates are available

This means saved project changes are newer than the published snapshot. Choose Update AI Context beside Saved or inside the modal.

If the update contains only presentation changes that do not affect semantic context, Skafold may keep the current revision while marking it current.

The AI cannot read the context URL

Confirm that the tool can make HTTPS requests and that the complete URL was copied. AI Context is a bearer link and does not use the user’s Skafold login session.

If the link was deleted, it cannot be restored. Create a replacement, share the new URL with the team, and update configured tools.

Do not post the URL in public support requests.

Skafold says a newer importer is available

The selected file was generated by a legacy Project Importer or uses an older AI workflow protocol. A compatible file may still be imported, but future files should be generated with the current skill.

  1. Open Install Skafold Project Importer.
  2. Download and install the latest plugin or standalone skill.
  3. Start a new AI task and generate the file again when necessary.

For existing projects, update AI Context in Skafold before regenerating if the installed protocol is not accepted by the published snapshot.

An update would remove content

Each supplied frame is a complete replacement. Missing items inside that frame are removals, while omitted frames are untouched.

Review the removal summary. If the deletion was not requested, ask the AI to regenerate the target from the latest context while preserving every unchanged item and stable ID.

A requested frame is missing

Opening import from a workspace's floating quick bar requires the file to contain that workspace. Either regenerate the update with the requested frame or open the same file from Project Tools → Import AI update when its supplied scope is correct.

Structure or Page Hierarchy is incomplete

Structure is the authoritative page list and direct hierarchy. Page Hierarchy contains planning and placements.

When adding or removing pages, ask the AI to target both frames. When removing a reusable Section used by a page, target Sections and Page Hierarchy together.

Shared Sections did not update as expected

Confirm that page placements use globalSectionId and that every reference exists in the Sections definitions.

Keep shared names, layout, notes, tags, and build guidance on the reusable definition. Use instanceName only for a page-specific placement label. Definition and placement status colours are independent.

You still need help

Include the validation message, format name, schema version, and a reduced non-sensitive example when you contact support. Never include AI Context URLs, credentials, private customer data, or production access tokens.