Why isn't my skill loading in the Claude Code menu?

This is often caused by a mismatch between the directory name and the name field in your SKILL.md. Validate-skills detects these naming mismatches and suggests the correct kebab-case format.

How does it improve skill security?

The validator scans your scripts for dangerous commands like 'rm -rf' without path validation, 'eval', or 'mkfs', providing safer alternatives to prevent accidental data loss.

Does this work with my pre-commit hooks?

Yes, validate-skills provides exit codes (0 for success, 1 for warnings, 2 for errors) making it easy to integrate into git hooks to prevent broken skills from being committed.

Can it fix tool permission errors?

Yes, it identifies if you have used incorrect capitalization for tools (e.g., 'bash' instead of 'Bash'), which is a common reason why Claude might refuse to execute a command.

Skill Validator

Name: Skill Validator
Author: pdugan20

bypdugan20

•

開発者ツール

Validates Claude Code skills for schema compliance, naming conventions, security vulnerabilities, and documentation standards.

The validate-skills skill is an essential linting utility for developers building custom capabilities for Claude Code. It provides automated checks for common configuration errors such as case-sensitive tool names, mismatches between directory names and skill metadata, and missing documentation. Beyond syntax, it serves as a security layer by scanning shell scripts for dangerous command patterns like unvalidated deletions, ensuring that every skill you build is robust, secure, and ready for production use.

主な機能

01Case-sensitivity checks for tool permissions and model names

022 GitHub stars

03Schema validation for SKILL.md frontmatter and metadata

04Security auditing for dangerous shell commands and path traversal

05Automated documentation checks for README and CHANGELOG files

06Directory organization and naming convention enforcement

ユースケース

01Troubleshooting skills that appear in the menu but fail to execute

02Identifying security risks in shell scripts before distribution

03Automating quality assurance in a CI/CD pipeline for skill repositories

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pdugan20/claudelint validate-skills

For use in Claude.ai and ChatGPT

主な機能

01Case-sensitivity checks for tool permissions and model names

022 GitHub stars

03Schema validation for SKILL.md frontmatter and metadata

04Security auditing for dangerous shell commands and path traversal

05Automated documentation checks for README and CHANGELOG files

06Directory organization and naming convention enforcement

ユースケース

01Troubleshooting skills that appear in the menu but fail to execute

02Identifying security risks in shell scripts before distribution

03Automating quality assurance in a CI/CD pipeline for skill repositories

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pdugan20/claudelint validate-skills

For use in Claude.ai and ChatGPT