skill-checker

Validate SKILL.md files against frontmatter, naming, and structure rules.

Updated Dec 24, 2025
One-click install
npx skills add https://github.com/MakotoUwaya/dotfiles --skill skill-checker-makotouwaya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-checker
Source: https://github.com/MakotoUwaya/dotfiles/tree/main/.config/claude-code/skills/skill-checker
Command: npx skills add https://github.com/MakotoUwaya/dotfiles --skill skill-checker-makotouwaya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the review process for SKILL.md files, ensuring they meet quality standards for syntax, naming, and description clarity, which is crucial for effective skill discovery and usage.

Core Features & Use Cases

  • Automated Validation: Checks SKILL.md files against a comprehensive set of rules including frontmatter, naming conventions, description quality, section structure, instruction clarity, example realism, and content consistency.
  • Quality Assurance: Identifies potential issues early in the development cycle, reducing review time and improving the overall quality of skills.
  • Use Case: Before merging a new skill into the repository, run this checker to ensure its SKILL.md is well-formed and clearly communicates its purpose and usage to other developers or the AI.

Quick Start

Run the skill-checker to validate all SKILL.md files in the ~/.claude/skills directory.

Frequently Asked Questions about skill-checker

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

FAQPage Schema
How do I validate SKILL.md files for frontmatter and structure consistency?

To validate SKILL.md files, use an automated checker that reviews frontmatter, naming conventions, section structure, instruction clarity, and content integrity against defined quality standards. This ensures skill discoverability and usability during the development cycle.

What is SKILL.md quality assurance and why is it needed?

SKILL.md quality assurance is the process of verifying syntax, naming, and description clarity in skill documentation. It is needed to ensure effective skill discovery and usage by enforcing standards before merging into a repository.

Can I check markdown documentation quality for multiple AI skills at once?

Yes, you can check markdown documentation quality for multiple AI skills by running a validation script across a specified directory. It identifies potential issues early, reducing manual review time and improving overall skill quality.

What's the best way to automate code review for skill documentation before merging?

The best way to automate code review for skill documentation is running a validation checker that enforces rules for frontmatter, descriptions, examples, and instructions. This catches formatting and consistency issues before repository integration.

Does the skill validation checker work without external dependencies?

Yes, the skill validation checker works without external dependencies. It operates using internal scripts to evaluate SKILL.md files against comprehensive rules for naming, structure, and content consistency.

What specific rules are checked during SKILL.md file validation?

SKILL.md file validation checks rules regarding frontmatter, naming conventions, description quality, section structure, instruction clarity, example realism, and content integrity to ensure well-formed documentation.