skill-qa

Validate SKILL.md files against Claude Code best practices.

Updated Dec 24, 2025
One-click install
npx skills add https://github.com/fzymgc-house/fzymgc-house-skills --skill skill-qa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-qa
Source: https://github.com/fzymgc-house/fzymgc-house-skills/tree/main/homelab/skills/skill-qa
Command: npx skills add https://github.com/fzymgc-house/fzymgc-house-skills --skill skill-qa

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the validation of SKILL.md files, ensuring they adhere to Claude Code's best practices for discoverability, clarity, and operational efficiency.

Core Features & Use Cases

  • Automated Skill Auditing: Checks SKILL.md for metadata completeness, conciseness, proper structure, workflow clarity, and common anti-patterns.
  • Quality Assurance: Use this skill to review and improve your skills before they are deployed or shared.
  • Use Case: Before releasing a new skill, run skill-qa on its SKILL.md to catch potential issues with its description or workflow instructions.

Quick Start

Run the skill-qa skill to validate the SKILL.md file in the current directory.

Frequently Asked Questions about skill-qa

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

FAQPage Schema
How do I validate a SKILL.md file against best practices?

To validate a SKILL.md file against best practices, run an automated auditing skill to check its metadata, structure, workflow clarity, and common anti-patterns for operational discoverability.

What is skill auditing for Claude Code discoverability?

Skill auditing for Claude Code discoverability is the process of reviewing SKILL.md files to ensure they meet standards for metadata completeness, conciseness, and proper workflow design before deployment.

How do I check my SKILL.md metadata for common anti-patterns?

You can check your SKILL.md metadata for common anti-patterns by running an automated quality assurance validation that scans for structural issues, workflow clarity, and script execution intent.

Does skill validation require any external dependencies?

Skill validation does not require external dependencies, as the auditing process operates directly on the SKILL.md file content and references to check metadata and operational clarity.

What is the best way to ensure skill operational clarity before deployment?

The best way to ensure skill operational clarity before deployment is to run an automated validation check on the SKILL.md file to catch potential issues with description and workflow instructions.

When should I not use automated SKILL.md validation?

You should not use automated SKILL.md validation when you need deep semantic logic testing, as the auditing process primarily focuses on metadata completeness, structure, and common anti-patterns.