Prepare a Skill Package for Upload
Focus
Focus
Prisma AIRS

Prepare a Skill Package for Upload

Table of Contents

Prepare a Skill Package for Upload

Learn the file requirements and best practices for packaging an AI skill before uploading it to Prisma AIRS AI Skill Security for scanning.
Where Can I Use This?What Do I Need?
  • Prisma AIRS (AI Skill Security)
  • No License required for preview
  • Prisma AIRS AI Skills Security Deployment Profile
An archive can contain a single skill or a batch of up to 100 skills. The archive structure determines how the scanner discovers and processes skills.
Upload skills as a ZIP archive that meets the following requirements.
RequirementLimit
FormatZIP archive
Maximum compressed size100 MB
Maximum uncompressed size500 MB
Number of skills per archive100

Single Skill Archive

Place SKILL.md at the root of the ZIP archive. Supporting files can be organized in subdirectories within the skill folder.
my-skill/ ├── references/ │ └── common-workflows.md ├── scripts/ │ └── do-query.py └── SKILL.md
my-skill/ └── SKILL.md

Batch Archive

Place each skill in its own directory at the root level of the ZIP archive. The SKILL.md file must be at the root of each skill directory. All skill directories must be at the same level. Nested directory structures are not supported. Directories without a valid SKILL.md are skipped and not scanned.
my-batch.zip/ ├── my-skill-1/ │ ├── references/ │ │ └── common-workflows.md │ ├── scripts/ │ │ └── do-query.py │ └── SKILL.md └── my-skill-2/ └── SKILL.md

Skill Package Contents

Your package must include a SKILL.md file with appropriate front matter that complies with the skill specification. Skills typically also include:
  • Supporting scripts
  • Prompt files
  • Configuration files
  • Example outputs or other reference assets
Avoid including the following items, which increase upload time and reduce scan performance:
  • Virtual environments
  • Build artifacts
  • Version control metadata
  • Dependency caches
  • Large files unrelated to the skill
Use the following example command to create a ZIP archive while excluding unnecessary components:
zip -r my-skill.zip . \ -x ".git/*" "__pycache__/*" "*.pyc" ".venv/*" "venv/*" "node_modules/*"