skill-tester

Validate agent skills against the Agent Skills Specification v1.0 and generate structured reports.

3|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/tnez/agent-skills --skill skill-tester
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-tester
Source: https://github.com/tnez/agent-skills/tree/main/meta/skill-tester
Command: npx skills add https://github.com/tnez/agent-skills --skill skill-tester

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solves? Ensuring agent skills are compliant and functional can be time-consuming and prone to manual oversight. This skill automates comprehensive validation, catching structural and specification issues before deployment.

Core Features & Use Cases:

  • Spec Compliance: Automatically test skills against the Agent Skills Specification v1.0.
  • Error Detection: Identify missing files, invalid YAML, name mismatches, and broken references.
  • Use Case: Before sharing a new skill with your team, run skill-tester to get a detailed report, ensuring it's robust and ready for use.

Quick Start: Test the skill located at 'my-new-skill' using the skill-tester.

Frequently Asked Questions about skill-tester

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

FAQPage Schema
How do I validate an agent skill against the specification before deployment?▼

Skill validation tests your agent skill against the Agent Skills Specification v1.0, checking directory structure, YAML frontmatter, required fields, and naming conventions. Run skill-tester on your skill directory to generate a detailed compliance report before sharing or deploying.

What structural issues does skill validation detect?▼

Skill validation detects missing SKILL.md files, invalid YAML frontmatter, mismatched directory and skill names, broken references, absent required fields, and malformed metadata. These checks catch deployment blockers early.

Can I test multiple skills for quality assurance at once?▼

Skill-tester validates individual skills against the specification. Run it on each skill directory to generate validation reports. For team-wide quality assurance, apply skill-tester before post-modification testing and compliance reviews to catch errors consistently.

What output does a skill validation report include?▼

Validation reports provide structured findings documenting all specification compliance checks: file presence, YAML validity, field completeness, name format adherence, and directory-name matching results for comprehensive error detection.

Do I need any dependencies to run skill validation?▼

Skill-tester has no external dependencies. It operates as a standalone script component that performs directory and file analysis, YAML parsing, and specification checks without requiring additional tools or libraries.