quality-checker

Validate Claude skill packages for structure, content, and standards compliance.

175|26|Updated Aug 14, 2025
One-click install
npx skills add https://github.com/jmagly/ai-writing-guide --skill quality-checker-jmagly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quality-checker
Source: https://github.com/jmagly/ai-writing-guide/tree/main/.factory/skills/quality-checker
Command: npx skills add https://github.com/jmagly/ai-writing-guide --skill quality-checker-jmagly

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires skill-builder, skill-enhancer, and includes references (resource) components.

What problem does it solve?

This Skill eliminates quality issues by automatically validating Claude skill packages for structure, content completeness, and standards compliance.

Core Features & Use Cases

  • Quality Validation: Automatically checks skill structure, SKILL.md content, code examples, and reference documentation.

Quick Start

Use this Skill before packaging to automatically validate your skill meets all quality requirements and generate a detailed quality report with recommendations.

Example Output

"Quality Report: <skill-name>

Summary:

  • Overall Score: XX/100
  • Status: PASS/WARN/FAIL

Structure (25/25):

  • [x] SKILL.md present
  • [x] references/ directory
  • [x] Reference files present

Content (30/35):

  • [x] Title present
  • [x] Description clear
  • [x] Quick reference
  • [ ] FAQ section (missing)

Recommendations:

  1. Add FAQ section based on common questions
  2. Include examples in other languages
  3. Add version/last updated info"

Frequently Asked Questions about quality-checker

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

FAQPage Schema
How do I validate a Claude skill package for quality before uploading?

Quality validation checks your skill's structure, SKILL.md content, references directory, and standards compliance automatically. Run the validator on your skill directory to generate a detailed report scoring completeness across structure, content, and documentation—catching issues before production deployment.

What does a quality validation report include?

The report scores overall quality out of 100, shows pass/warn/fail status, and breaks down validation results by category: structure (SKILL.md, references present), content (title, description, examples), and completeness. It flags missing sections and recommends improvements like adding FAQs or multilingual examples.

Can I run quick validation or do a full check of my skill package?

You can specify validation scope as quick, full, or custom. Quick validation checks essential structure; full validation covers completeness and standards compliance across all quality dimensions. Choose the scope that fits your workflow stage—quick for early development, full before final packaging.

What are the required inputs for validating a skill?

Provide your skill directory, ensure SKILL.md is present, define quality criteria upfront, and specify your validation scope explicitly. The validator enforces these requirements and checks alignment with documented grounding, uncertainty escalation, context scope, and quality standards.

How does quality validation fit into the skill packaging workflow?

Validation runs before packaging to catch structure, content, and compliance issues early. It depends on skill-builder and skill-enhancer outputs—ensuring your skill meets all production-ready requirements and standards before upload, reducing post-deployment quality problems.

What happens if my skill fails quality validation?

The report identifies gaps—missing SKILL.md sections, incomplete references, or unmet quality criteria—and provides specific recommendations. Address flagged items, rerun validation to confirm fixes, and iterate until you achieve pass status for production deployment.