This quickstart walks you through the full bootstrap sequence from a blank ChatGPT Project to an active, loaded skill. By the end you will have the system core unpacked, theDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/XxYouDeaDPunKxX/ChatGPT-SKILL-SYSTEM/llms.txt
Use this file to discover all available pages before exploring further.
skill-adapter skill physically installed, and that skill semantically active in your session — ready to inspect and adapt external skill packages.
Add packages to your Project
Upload two files to your ChatGPT Project’s sources:
dist/GPT.SKILLS.zip— the core runtime packagedist/skills/skill-adapter.zip— the bundled adapter skill
CUSTOM_INSTRUCTIONS.txt into the Project instructions field. These instructions tell ChatGPT to unpack GPT.SKILLS.zip into /mnt/data/GPT.SKILLS/ at startup and immediately read the core manifest at /mnt/data/GPT.SKILLS/SYSTEM_CORE/MANIFEST.json.Both ZIPs must be present as Project sources before you start a chat. Skill ZIPs added later require a new chat to be seen by the boot sequence.
Start a new chat
Open a new chat inside the Project. The Project instructions fire automatically at the start of the conversation. The core auto-unpacks When the boot succeeds, the model confirms the core is active for the current session.
GPT.SKILLS.zip into /mnt/data/GPT.SKILLS/, validates SYSTEM_CORE/MANIFEST.json, and loads the core files declared in its load_sequence:Boot the core explicitly (if needed)
If the auto-unpack did not fire — for example, because the Project instructions were not saved before the chat started — trigger core boot manually by typing:This command removes any previous
/mnt/data/GPT.SKILLS/ tree, extracts GPT.SKILLS.zip fresh, validates the manifest, and activates the core. Running it again in the same session resets the active semantic state and clears any previously loaded skills.Unpack the skill
Install The system verifies that The skill is now installed on disk. It is not yet active — unpack is a physical operation only.
skill-adapter physically into the skill directory by typing:skill-adapter.zip has a flat root, a valid MANIFEST.json whose skill_name equals skill-adapter, and safe internal paths. It then extracts the archive into:Load the skill
Make The loader reads the skill’s manifest, walks its
skill-adapter semantically active for this session by typing:load_sequence, and mounts each declared instruction file into the current session context. Once this command succeeds, the skill is active and the model applies its guidance to relevant tasks in this chat.Session boundary — The active skill set exists only inside the current chat. When you open a new chat (even in the same Project), the session resets. Repeat the boot and load steps to rebuild your active skill set in the new chat. This is by design: each session starts with a clean, targeted context.
Next steps
Core Concepts
Understand the session-first model and what loading really means.
Session Lifecycle
Learn how sessions start, reset, and end.
Loading Skills
Explore load sequences, fallback mode, and reload behavior.
Skill Package Format
Build your own skill package from scratch.