chatgpt-import

Convert ChatGPT export ZIP conversations into Vellum's import schema.

2|2|Updated May 13, 2026
One-click install
npx skills add https://github.com/autonomy-cloud/kairos-interface --skill chatgpt-import-autonomy-cloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chatgpt-import
Source: https://github.com/autonomy-cloud/kairos-interface/tree/main/skills/chatgpt-import
Command: npx skills add https://github.com/autonomy-cloud/kairos-interface --skill chatgpt-import-autonomy-cloud

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bun, and includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of losing conversational context and memory when switching away from ChatGPT by converting exported ChatGPT conversation data into a format Vellum can ingest.

Core Features & Use Cases

  • Conversation import from ChatGPT exports: Converts ChatGPT’s ZIP export (including conversations.json) into the standard Vellum conversations import schema.
  • User/assistant message filtering: Imports only user and assistant messages, ignoring system prompts and tool-call content that are not intended for chat history continuity.
  • Deduplication-friendly imports and indexing: Produces stable sourceKey values so re-imports skip duplicates and imported conversations get indexed for memory search.

Quick Start

Ask the user to export their ChatGPT data as a ZIP file, upload it, then run the provided import command to parse the ZIP and load the conversations into Vellum.

Frequently Asked Questions about chatgpt-import

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I import my ChatGPT conversation history into Vellum?

ChatGPT conversation history import requires filtering the conversations.json file from a ChatGPT export ZIP to retain only user and assistant messages, then piping the transformed data to the assistant conversations import command.

What is the process for migrating ChatGPT data to a personal assistant workflow?

Migrating ChatGPT data requires exporting chats as a ZIP file, parsing the JSON conversation data while ignoring system prompts and tool calls, and loading filtered messages to preserve conversational memory continuity.

Do I need Bun to run the ChatGPT data migration scripts?

Yes, Bun is a required dependency for running the scripts that parse the ChatGPT ZIP archive and transform conversation data into the Vellum import schema.

Does the import process deduplicate ChatGPT conversations?

Yes, the import process generates stable sourceKey values for each conversation, ensuring that re-importing the same ChatGPT data skips duplicates and properly indexes conversations for memory search.

Are original timestamps retained when importing ChatGPT exports?

Yes, the transformation to the Vellum import schema retains original timestamps from the ChatGPT conversations.json file to ensure accurate conversation reconstruction.

What message types are ignored during ChatGPT history conversion?

The conversion ignores system prompts and tool-call content, importing only user and assistant messages to maintain chat history continuity without internal operational data.