Skills

Package requirements

Archive format requirements for skill uploads.

Requirements for .zip and .skill archives uploaded via Create and 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.