Troubleshoot AI Skill Security Scans
Focus
Focus
Prisma AIRS

Troubleshoot AI Skill Security Scans

Table of Contents

Troubleshoot AI Skill Security Scans

Resolve common issues with AI Skill Security scans, including scan failures, delayed results, and scans with no findings.
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
If a scan does not complete, verify that the archive meets the requirements for its archive type. For correct archive layouts, see Prepare a Skill Package for Upload.

Single Skill

Verify that the single-skill archive meets the following requirements:
  • Is a valid ZIP file
  • Contains exactly one skill
  • Includes exactly one SKILL.md file at the root level of the skill folder
  • Has name and description fields in the frontmatter of the SKILL.md file
This archive does not complete because the markdown file is incorrectly named:
my-skill/ ├── references/ │ └── common-workflows.md ├── scripts/ │ └── do-query.py └── BADLYNAMEDFILE.md
This archive does not complete because SKILL.md is not at the root level of the skill folder:
my-skill/ ├── references/ │ └── SKILL.md └── scripts/ └── do-query.py

Batch

Verify that the batch archive meets the following requirements:
  • Contains two or more skill directories
  • Each skill directory is at the same level under the ZIP root
  • Each skill directory contains a SKILL.md file at its root
  • Does not contain a SKILL.md file at the ZIP root
This batch archive does not complete because it contains only one skill directory. A batch archive must contain two or more skill directories:
my-batch.zip/ └── skill-one/ └── SKILL.md
This archive does not complete because SKILL.md appears at the ZIP root and also in a nested subdirectory:
my-skill/ ├── SKILL.md └── subfolder/ └── SKILL.md
This batch archive does not complete because the skill is nested inside a subdirectory rather than placed at the root of its skill folder:
my-batch.zip/ └── skill-1/ └── dir-1/ └── dir-2/ └── SKILL.md

Scan Taking Longer Than Expected

Most scans complete within seconds, but additional analysis can take up to 5 minutes. Once a skill is scanned for the first time, subsequent scans of skills with the same fingerprint are nearly instant. If a scan remains in progress significantly longer than expected, refresh the page or start a new analysis.

No Findings Detected

A scan without findings indicates that no enabled security or governance rules were triggered for the uploaded skill. Review skills using your existing approval processes before deployment even when no findings are detected.

Need Help?

If you experience issues using AI Skill Security, contact your Palo Alto Networks support representative.