Skafold Documentation

Working With AI

Install Skafold Project Importer

Install the AI skill that creates new Skafold projects and focused updates from live AI Context.

Skafold Project Importer supports both directions of the AI workflow:

  • Turn a planning conversation into a validated project seed for a new Skafold project.
  • Read an existing project’s AI Context URL and create one update file containing exactly the requested frames.

The installed skill includes its schemas, guidance, examples, and validators locally. This keeps generation fast and predictable. Download a new version when Skafold adds or changes supported nodes, frames, schemas, or generation guidance.

Skafold Project Importer

Create new-project seeds and focused updates from a project's live AI Context. Download the plugin, then install the complete folder with Plugin Creator.

Plugin 2.4.0 · Skill 2.4 · Install with Plugin Creator

Choose the right download

  • Download plugin is recommended for ChatGPT and Codex in the desktop app. It includes the plugin manifest, skill, local references, schemas, and validators for both project seeds and frame updates.
  • Standalone skill is for Claude or another tool that accepts an Agent Skills folder but does not install Codex plugins.

Install in ChatGPT or Codex

Use the built-in Plugin Creator to validate and install the downloaded package.

  1. Download and extract skafold-project-importer-plugin-v2.4.0.zip.
  2. Start a new ChatGPT or Codex task without selecting a project.
  3. Select Plugin Creator from the skill picker. In ChatGPT mention it with @; in Codex mention $plugin-creator.
  4. Attach the complete extracted plugin folder.
  5. Ask:
Install this plugin.
  1. Approve the requested personal plugin-folder, marketplace, and enablement changes.
  2. Start a new task so ChatGPT or Codex loads the installed skill.

Use it for a new project

Start with discovery rather than asking for JSON immediately:

Use Skafold Project Importer to help plan this project. Keep assumptions and open questions separate, and do not create the import file until I confirm the plan is ready.

When the plan is confirmed:

Create one validated Skafold project seed from the confirmed plan.

Import the resulting skafold-project-seed JSON from the Skafold dashboard.

Use it for an existing project

Copy the project’s AI Context URL from Project Tools → AI Context and provide it to the AI immediately before requesting changes:

Use this Skafold AI Context URL as the current source of truth. Update Structure and Page Hierarchy to add the confirmed Services pages. Return one validated Skafold frame-update file and leave every other frame unchanged.

The AI fetches the live snapshot and uses the protocol guidance bundled with the installed skill. It must not ask you to download the current project JSON or a Markdown context package.

Treat the AI Context URL as a secret bearer link. Anyone with the URL can read the published project context.

Local knowledge and live project context

At file-generation time the skill:

  1. Reads the schemas, generation guidance, node knowledge, and examples installed with the skill.
  2. Fetches only the live bearer AI Context URL when updating an existing project.
  3. Confirms the installed frame-update protocol is accepted by that snapshot.
  4. Runs the bundled validator before returning the import file.

If an AI Context snapshot is too old for the installed skill, update AI Context in Skafold and ask the AI to fetch the URL again.

Install the standalone skill

  1. Download skafold-project-importer-v2.4.zip.
  2. Upload the ZIP through your AI tool’s Skills or Capabilities settings.
  3. Enable it and start a new conversation.
  4. Explicitly select the skill if the tool does not invoke it automatically.

For a tool that accepts instructions and knowledge files rather than native skills, use the body of SKILL.md as its instructions and upload the files under references. The tool needs HTTPS access to read existing-project AI Context and file creation or code execution for reliable validation.

What the plugin contains

  • SKILL.md defines discovery, new-project generation, and existing-project updates.
  • project-seed.schema.json defines new-project imports.
  • ai-context.schema.json defines the live read-only snapshot.
  • frame-update.schema.json defines the single existing-project update format.
  • project-importer-guidance.md, node-types.md, and section-presets.md guide generation.
  • validate-skafold-project-import.mjs validates new-project seeds when Node.js is available.
  • validate-skafold-frame-update.mjs resolves the bundled cross-file schemas and validates existing-project updates before handoff.
  • agents/openai.yaml supplies ChatGPT and Codex skill metadata.

See Version history for current plugin, skill, and AI workflow versions.