Version history

Use this page to understand which Skafold Project Importer, skill, and exchange versions are current.

For product release notes, see Product Updates.

Current versions

What plugin version 1.0.3 adds

This plugin update includes:

• Installation through a local Codex plugin marketplace.
• Native discovery in ChatGPT and Codex.
• Branded plugin and skill metadata.
• A dependency-free validator for schema rules, references, duplicate IDs, and page hierarchy cycles.
• A separate standalone skill archive for Claude, Gemini, and legacy custom-instruction workflows.
• Sections-frame guidance for stable reusable names, page-specific instance labels, and independent library and page status colors.
• Reusable-by-default section guidance with canonical definitions and lightweight page placements.
• Lossless preservation of Skafold canvas layout data during unchanged AI round trips.
• Ordered reusable-section dividers with cross-reference validation.

What Project Importer skill version 1.12 covers

The current skill and schema support:

• Discovery-first planning before project import-file generation.
• Page hierarchy with section names, layout hints, notes, tags, build guidance, and flexible workflow status colors.
• Reusable-by-default sections through canonical globalSections definitions and a globalSectionId on every page placement.
• Stable reusable section definitions, optional page-specific instanceName values, and independent status colors for the library definition and each page placement.
• Ordered reusable-section dividers plus stable grouping through kind: "separator" and definition groupId.
• Opaque canvas preservation when revising a Skafold-exported package.
• User journeys separate from primary page hierarchy, with typed tracking, decision, and note callouts.
• Technical architecture items and typed relationships.
• Design guidance fields for direction, colors, typography, layout, imagery, motion, UI treatment, avoid notes, and design-system notes.
• Assumptions and open questions.
• Deterministic validation when Node.js execution is available, with direct schema validation as the fallback.

Compatibility rules

Skafold currently imports only:

{
  "format": "skafold-context",
  "version": "1.0"
}

When an AI revises an exported file, ask it to preserve:

• Existing IDs for unchanged records.
• globalSections and globalSectionId.
• The order, kind, and groupId of reusable sections and organizational dividers.
• layout, notes, tags, buildGuidance, and statusColor. Legacy completed: true remains compatible and imports as green.
• The top-level canvas object byte-for-byte when it is present.
• Assumptions and open questions that still apply.

Preserving these fields helps Skafold reuse existing nodes, connector paths, Page Hierarchy card positions, and shared section references during replacement imports.

When to update the plugin or skill

Download and reinstall the Project Importer plugin when Skafold announces:

• A new plugin version.
• A new generator.skillVersion.
• New schema fields.
• Changed section pattern names.
• Project JSON import or round-trip behavior changes.
• New AI planning guidance.

For ChatGPT or Codex, download the new plugin archive and give the extracted folder to Plugin Creator in a task without a project selected. Approve the requested update and enablement changes, then begin a new task. For Claude, Gemini, or another standalone configuration, replace the prior skill and reference files.