skill-reviewer

Validate Claude Code skills against best practices and quality standards.

2|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/nakano1122/dotfiles --skill skill-reviewer-nakano1122
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-reviewer
Source: https://github.com/nakano1122/dotfiles/tree/main/dot_agents/skills/skill-reviewer
Command: npx skills add https://github.com/nakano1122/dotfiles --skill skill-reviewer-nakano1122

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the review of Claude Code skills, ensuring they adhere to best practices for structure, content, and metadata, thereby improving overall skill quality and discoverability.

Core Features & Use Cases

  • Automated Validation: Checks SKILL.md frontmatter (name, description rules) and body content (line count, structure).
  • Reference Structure Check: Validates the organization and content of references/ directories.
  • Anti-Pattern Detection: Identifies common pitfalls in skill design and implementation.
  • Use Case: After developing a new skill, use this reviewer to automatically flag any violations of naming conventions, description length, or structural guidelines before submitting it for integration.

Quick Start

Run the skill-reviewer to check the quality of the 'api-design' skill.

Frequently Asked Questions about skill-reviewer

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

FAQPage Schema
How do I validate Claude Code skills against best practices?

You can validate Claude Code skills against best practices by running an automated auditing process that checks SKILL.md frontmatter, body content, and directory structure.

What are common anti-patterns in Claude Code skill design?

Common anti-patterns in Claude Code skill design include frontmatter naming violations, improper description length, and missing structural guidelines, which automated validation tools can automatically detect.

Does Claude Code skill validation check the references directory structure?

Yes, Claude Code skill validation checks the references directory structure by verifying the organization and content of files within the references folder to ensure proper skill integration.

Can I automate skill auditing before submitting a new Claude Code skill?

You can automate skill auditing before submitting a new Claude Code skill by running a validation check to automatically flag any violations of naming conventions, description length, or structural guidelines.

What frontmatter rules do I need to follow for SKILL.md files?

For SKILL.md files, frontmatter rules require specific name and description conventions that automated validation enforces to ensure overall skill quality and discoverability.