skill-tester

Validate skill directories for structural compliance and Python script quality.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill skill-tester-veloxia-agency
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-tester
Source: https://github.com/Veloxia-agency/VELOXIA-WEB/tree/main/.claude/skills/engineering/skills/skill-tester
Command: npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill skill-tester-veloxia-agency

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) and references (resource) components.

What problem does it solve?

It removes the guesswork from skill maintenance by validating whether a skill directory is structured correctly, documented completely, and implemented with reliable Python tooling.

Core Features & Use Cases

  • Structure Validation: Checks that required files and directories are present and aligned with the expected skill specification.
  • Script and Quality Testing: Inspects Python scripts for syntax, argparse usage, main guards, output formats, and overall implementation quality.
  • Use Case: A repository maintainer can run the tester on a skill before merge to catch missing frontmatter, weak documentation, broken scripts, or noncompliant directory layouts.

Quick Start

Ask the Skill Tester to inspect a skill directory and return a validation report with compliance issues, quality scores, and improvement suggestions.

Frequently Asked Questions about skill-tester

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

FAQPage Schema
How do I validate skill directory structure and documentation completeness before a repository merge?

To validate skill directory structure and documentation completeness before a merge, run a validation tool that parses YAML frontmatter, inspects required files like SKILL.md, and enforces directory layout standards to return a dual-format compliance report.

What does Python AST analysis check for when validating script quality in a CI/CD pipeline?

Python AST analysis checks script quality in a CI/CD pipeline by inspecting abstract syntax trees for syntax errors, argparse usage, main guards, and output formats to ensure reliable implementation before deployment.

Can I use PyYAML to parse frontmatter and enforce standards for optional assets in skill directories?

Yes, you can use PyYAML to parse frontmatter and enforce standards for optional assets in skill directories, verifying that required files, scripts, references, and optional components meet structural and documentation specifications.

What's the best way to automate quality assurance for Python scripts and catch missing frontmatter in CI/CD gates?

The best way to automate quality assurance for Python scripts and catch missing frontmatter in CI/CD gates is to run directory inspection and AST analysis scripts that generate compliance issues, quality scores, and improvement suggestions automatically.

Why does my skill validation report show incomplete documentation errors after inspecting my directory layout?

Skill validation reports show incomplete documentation errors when directory inspection finds missing or non-compliant SKILL.md files, broken scripts, or absent YAML frontmatter required by the skill specification standards.

Does skill validation work with dual-format reporting for both structural compliance and script quality testing?

Yes, skill validation works with dual-format reporting to output both structural compliance checks for required files and directories, alongside script quality testing results for syntax, argparse usage, and main guards.