> For the complete documentation index, see [llms.txt](https://sebun1.gitbook.io/skins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sebun1.gitbook.io/skins/packaging/general-distribution.md).

# General Distribution

## Distribute `skinspkg`

This is the recommended method of distribution outside of Thunderstore. The `.skinspkg` format provides a unified single-file way to export and import skins; the export can be easily done in the editor.

To export a `skinspkg` package:

{% stepper %}
{% step %}

### Switch to the Packages mode in the Editor

Click on the <kbd>Packages</kbd> tab in the editor to switch to it.

<div align="left" data-with-frame="true"><figure><img src="/files/ZYyur6rY3MEMTVcZdTVw" alt="" width="266"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Select the package

Add a new package or select an existing package.

Also fill out any necessary details you wish to include.
{% endstep %}

{% step %}

### Add Skin Groups to include

Add the Skin Groups you want to include with the package.

<div align="left" data-with-frame="true"><figure><img src="/files/Zo41XsXYjHR87In1m9Dq" alt="" width="410"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Export as `skinspkg`

Click on the export button and click on <kbd>Export .skinspkg</kbd>.

<div align="left" data-with-frame="true"><figure><img src="/files/Py1B167UJr8UkR5VUOax" alt="" width="368"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Select export location and distribute

Select where to save the exported package and then distribute it!
{% endstep %}
{% endstepper %}

## Legacy Documentation

If you have followed through either [editing skin groups with the editor](/skins/editor/editor.md) or the [schema](/skins/schema/overview.md), what is required for packaging should be rather clear.

{% hint style="success" %}
**TL;DR;**\
The only thing needed is the containing folder of the skin group `manifest.skingroup.json` file.
{% endhint %}

{% hint style="warning" icon="input-text" %}
As a reminder. Please use sufficiently unique and meaningful GUIDs for your Skin Groups!
{% endhint %}

As mentioned, the only thing that should be distributed is the containing folder of the `manifest.skingroup.json` file — this is the smallest valid unit of distribution.

It is <mark style="background-color:$warning;">**necessary**</mark> that no references inside the Material Targets are located outside the Skin Group folder itself. Otherwise, these will become broken references once distributed.

It is also preferable to be as clear as possible on how to install the skins within your package. The easiest way to do this is to distribute only the Skin Group folders themselves (with no parent folders) in your compressed archive (or your preferred medium). It also doesn't hurt to include a link to [(LEGACY) Unpacking Skins for Installation](/skins/plugin/obtaining-skins/legacy-unpacking-skins-for-installation.md) inside your package for fallback.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sebun1.gitbook.io/skins/packaging/general-distribution.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.