Working With AI
AI compatibility and versions
Track Project Assistant releases, AI protocol versions, and JSON compatibility.
Use this page for AI workflow compatibility. To review or restore project edits, use History, milestones, and restore. For product releases, see Product Updates.
Current versions
| Area | Current version | Purpose |
|---|---|---|
| Project Assistant plugin | 3.2.0 | Current patterns, starter fields and Pages editing guidance. |
| Project Assistant skill | 3.2 | The same guidance, catalogue and validator in a standalone package. |
| AI workflow protocol | 1.14 | Pattern and field references for read-only context and new-project generation. |
| Project seed schema | 1.0 | Creates a separate new Skafold project. |
| AI Context schema | 1.0 | Describes a published project snapshot. |
Project Assistant 3.2 — protocol 1.14
Plugin 3.2.0 and standalone skill 3.2 share a pattern catalogue generated from the app, including long-form content, policies, FAQs and common utility sections. Seeds use the chosen layout and include their intended content fields explicitly. The pattern and fields remain independent after import.
Computer-use guidance now covers opening section details directly, the combined Content tab, searchable Patterns and Base blocks, keeping or replacing existing fields, and autosave verification. The seed and AI Context schemas remain at 1.0; this is a guidance and reference update, not a new import format. Existing seeds remain supported and historical protocol resources are unchanged.
Install the updated plugin or standalone skill to load these instructions. Update AI Context in Skafold to publish a snapshot referencing protocol 1.14.
Project Assistant 3.1.3 — single-plugin download
Updated the ZIP layout to match ChatGPT's single-plugin upload requirements. The planning guidance and standalone skill remain on version 3.1.
Project Assistant 3.1.2 — plugin upload packaging
The earlier packaging change did not resolve ChatGPT upload errors. This download is superseded by version 3.1.3.
Project Assistant 3.1.1 — readable download files
Added readable file permissions to plugin and standalone skill ZIPs. This did not resolve the reported plugin upload failure; use the latest plugin download. The planning guidance remains on skill version 3.1.
Project Assistant 3.1 — protocol 1.13
New seeds use page names, paths, context, hierarchy and section placements. Page requirements belong in editable page context, Documentation, or section guidance; the assistant no longer generates page planning fields without editor controls. Section build guidance and content-field guidance remain available.
Seed layouts can arrange nodes and connectors. Skafold sets native node widths and lets content determine height. Older seeds still import, with warnings when their dimensions are ignored or legacy page planning fields are retained in AI Context. Existing projects and historical snapshots are not rewritten.
Project Assistant 3.0 — protocol 1.12
Existing-project bulk updates are retired, including single-frame update files. Agents use computer use through the signed-in editor for focused edits. Substantial rebuilds use seeds to create separate projects with their own histories. Both download formats include explicit collaboration, save verification, and recovery guidance; neither includes a frame-update schema or validator.
The package identifier remains skafold-project-importer for installation continuity. Existing installed skills must be upgraded. Publish AI Context to refresh older snapshots to the current protocol; old snapshots and archived resources do not re-enable bulk imports.
The following entries describe historical releases. Their former acceptance of update files does not apply to the current product.
Typography refinements — protocol 1.11
Typography items can retain weight, italic style, preview source, fallback and optional font reference or public font-file URLs through AI Context and project imports. Preview fonts load in the browser when a project opens. Earlier supported updates remain accepted and preserve existing font details when those fields are omitted. Historical protocol resources remain unchanged.
Project Importer 2.4
Version 2.4 makes choice authoring label-only for radio buttons, dropdowns, and checkbox groups. The skill generates internal choice values and preserves them when labels or order change. Markdown handoffs show labels; JSON keeps the existing label/value structure for stable imports. Explicit CMS value requirements belong in field guidance.
Protocol 1.10 publishes the updated guidance. Earlier supported frame updates remain accepted, and historical protocol resources are unchanged. Update the installed importer and republish AI Context to use the new guidance.
Project Importer 2.3
Version 2.3 adds the expanded section schema types in protocol 1.9: common inputs, choice lists with display labels and stored values, media fields, content references, single object groups, and a Custom escape hatch with a type name and guidance. The bundled guidance and validators preserve these fields through project seeds and frame updates.
Update the installed importer before working with these types, then update AI Context in Skafold and fetch the same URL again. Earlier supported frame-update versions and existing section definitions remain accepted; historical protocol resources are unchanged.
Project Importer 2.2
Version 2.2 aligns the bundled schemas with protocol 1.8 and includes the shared validator helper in both plugin and standalone downloads. Protocol 1.8 preserves the current Section content fields and repeating groups in a coherent immutable release. Earlier supported frame-update versions remain accepted.
After installing this release, update AI Context in Skafold if the snapshot does not yet advertise protocol 1.8, then ask the AI to fetch the same URL again.
Project Importer 2.1
Version 2.1 packages schemas, guidance, examples, and validators directly with the installed skill. File generation no longer downloads protocol resources or manifests. Existing-project updates still fetch the live bearer AI Context URL immediately before planning.
When a user selects a file generated with a legacy importer or protocol, Skafold now points them to the current download documentation from the import screen.
Project Importer 2.0
Version 2.0 introduced the former round-trip workflow:
skafold-project-seedfor new projects.- A stable AI Context bearer URL for existing projects.
- One
skafold-frame-updateformat for any update scope. - Per-frame baselines so unrelated team changes do not automatically block a focused update.
- Versioned schemas and guidance for project seeds and frame updates.
- Stable-ID and cross-frame dependency rules for Structure, Sections, and Page Hierarchy.
- A dedicated frame-update validator that resolves the protocol's linked schemas and reports canonical ordering before handoff.
Protocol 1.7 adds the independently updateable Pre-flight frame, Project Resource links, repeatable titled Design References, and repeatable Typography role/name pairs. Earlier immutable protocol releases remain available for snapshots already pinned to them.
Installed skill updates
Install the current plugin or standalone skill and start a new task to load the new instructions. The website cannot update copies already installed in another AI tool.
New-project generation uses local references and the seed validator. Existing-project editing uses the computer-use guide and the current signed-in editor. AI Context is optional read-only background, not write access.
The supported JSON formats are skafold-project-seed and skafold-ai-context, both with schema version 1.0. Legacy skafold-context and skafold-frame-update files are not supported import contracts.