What does the Skill Reviewer check for?

It evaluates YAML frontmatter, description length, content scope, security anti-patterns, and portability to ensure compliance with Anthropic's standards.

Does it support checking for cross-platform compatibility?

Yes, it flags absolute or platform-specific paths (like Windows C:\ drives) and suggests portable alternatives like relative paths or placeholders.

Can it detect security vulnerabilities in my skills?

Yes, it specifically scans for hardcoded credentials, API keys, database tokens, and sensitive data to ensure they are moved to environment variables.

Why is progressive disclosure important for Claude skills?

It allows Claude to understand what a skill does without loading the full content immediately, keeping the context window efficient and reducing token costs.

What metrics does the review provide?

The review provides character counts for descriptions, line counts for content, YAML validity status, and security compliance checks.

Claude Skill Reviewer

Name: Claude Skill Reviewer
Author: theflysurfer

bytheflysurfer

Security & Testing

Reviews and validates Claude skills against Anthropic's official design philosophy and best practices.

About

The Claude Skill Reviewer is a specialized utility designed to ensure custom skills adhere to Anthropic's official design specifications. It automatically audits skill files for proper YAML frontmatter, concise descriptions, focused scope, and security best practices like avoiding hardcoded credentials. By providing structured feedback and performance metrics, it helps developers build high-quality, portable, and efficient skills that integrate seamlessly with Claude's progressive disclosure architecture.

Key Features

Generates structured review reports with actionable improvement recommendations
Audits skill content for conciseness and progressive disclosure compliance
0 GitHub stars
Validates YAML frontmatter against official Anthropic specifications
Detects security risks like hardcoded API keys, passwords, and tokens
Identifies portability issues such as absolute file paths or platform-specific commands

Use Cases

Ensuring internal development teams follow standardized AI skill patterns
Auditing a newly created skill before publishing to a shared repository
Refactoring legacy skills to meet updated Anthropic design guidelines

About

Key Features

Generates structured review reports with actionable improvement recommendations
Audits skill content for conciseness and progressive disclosure compliance
0 GitHub stars
Validates YAML frontmatter against official Anthropic specifications
Detects security risks like hardcoded API keys, passwords, and tokens
Identifies portability issues such as absolute file paths or platform-specific commands

Use Cases

Ensuring internal development teams follow standardized AI skill patterns
Auditing a newly created skill before publishing to a shared repository
Refactoring legacy skills to meet updated Anthropic design guidelines