# Package requirements

Archive format requirements for skill uploads.



Requirements for `.zip` and `.skill` archives uploaded via [Create](/api/skills/create) and [Update](/api/skills/update).

* File extension must be `.zip` or `.skill`.
* Maximum file size: 32 MB.
* The archive must contain a `SKILL.md` file with YAML frontmatter including `name` and `description`. It can be at the archive root or inside a single top-level subdirectory (for example `my-skill/SKILL.md`).
* `name`: lowercase letters, digits, and hyphens only. Max 64 chars. No consecutive hyphens. Cannot start or end with a hyphen.
* `description`: max 1024 chars.
* Allowed subdirectories: `scripts/`, `references/`, `assets/`. Other directories generate warnings but do not fail the upload.
* Skill names must be unique within an organization.