Skills
Package requirements
Archive format requirements for skill uploads.
Requirements for .zip and .skill archives uploaded via Create and Update.
- File extension must be
.zipor.skill. - Maximum file size: 32 MB.
- The archive must contain a
SKILL.mdfile with YAML frontmatter includingnameanddescription. It can be at the archive root or inside a single top-level subdirectory (for examplemy-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.