skill-validator

Validate agent skill folders for structure, quality, and isolation.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/prulloac/git-blame-vsc --skill skill-validator-prulloac
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-validator
Source: https://github.com/prulloac/git-blame-vsc/tree/main/.agents/skills/skill-validator
Command: npx skills add https://github.com/prulloac/git-blame-vsc --skill skill-validator-prulloac

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Validate agent skill folders to ensure they are correct, readable, isolated, and installable without dependencies on other skills.

Core Features & Use Cases

  • Structure validation: Verifies SKILL.md presence and optional subdirectories (scripts/, references/, assets/).
  • Quality checks: Assesses frontmatter, readability, cross-references, and isolation from other skills.
  • Security readiness: Performs automated security checks and produces an audit-style report.

Quick Start

Run the validator on a skill folder to confirm its SKILL.md structure, frontmatter, and isolation.

Frequently Asked Questions about skill-validator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate an agent skill folder for standalone use?

To validate an agent skill folder, run the validator to confirm its SKILL.md structure, frontmatter, and isolation from external dependencies. This ensures the folder is correct, readable, and installable without relying on other skills.

What does skill structure validation check for in a SKILL.md file?

Skill structure validation checks for SKILL.md presence, verifies frontmatter, and assesses optional subdirectories like scripts, references, and assets. It ensures documentation quality, cross-references, and isolation from other skills.

Can I perform a security audit on agent skills before deployment?

Yes, you can perform a security audit on agent skills. The validator executes automated security checks and produces an audit-style report with a pass or fail result, ensuring readiness and isolation from external dependencies.

What is the best way to check if a skill has external dependencies?

The best way to check for external dependencies is running a validation pass that assesses skill isolation. It detects duplicate references and verifies the folder operates independently without requiring other skills to function.

Do I need a specific folder structure to validate agent skills?

You need a SKILL.md file with frontmatter for validation. Optional subdirectories like scripts, references, and assets are also verified to ensure the folder structure meets quality and readability standards.

Why does skill validation produce a token-weight assessment?

Skill validation produces a token-weight assessment to quantify the documentation and structural content size. This structured report helps developers understand the overhead and verify isolation during the comprehensive audit workflow.