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.