What are the naming conventions for skills?

Skills must use lowercase alphanumeric characters and hyphens, matching their parent directory name exactly to ensure discoverability.

Can I integrate this linter into my GitHub Actions?

Yes, the provided validation script is designed to run in CI/CD environments and returns standard exit codes for build pipelines.

What is the agentskills.io specification?

It is a standardized format for defining AI skills, focusing on progressive disclosure, specific directory structures, and token-efficient content.

Why does the linter flag ASCII art and personas?

LLMs tokenize text character-by-character rather than visually; ASCII art and decorative personas waste tokens without improving the model's functional output.

Skill Specification Linter

Name: Skill Specification Linter
Author: majesticlabs-dev

bymajesticlabs-dev

•

開発者ツール

Validates Claude Code skills against the agentskills.io specification to ensure metadata compliance and token efficiency.

概要

The Skill Specification Linter is a specialized quality assurance tool designed to enforce the agentskills.io standard for Claude Code skills. It automatically audits frontmatter fields, directory structures, and content quality rules—such as the prohibition of token-wasting ASCII art and persona statements—to ensure skills are optimized for LLM performance. This tool is essential for developers contributing to marketplaces or maintaining internal skill repositories who need to run automated quality gates and maintain high structural standards.

主な機能

Content quality enforcement to remove ASCII art and persona-based roleplay
Directory structure and file naming integrity checks
Regex-based detection for deprecated command and agent invocation patterns
18 GitHub stars
Automated frontmatter validation for name, description, and metadata constraints
Strict line-limit monitoring to maintain a 500-line token budget

ユースケース

Validating new skill submissions before merging them into a marketplace
Refactoring existing skills to improve performance and reduce token consumption
Integrating quality gates into CI/CD pipelines for automated skill auditing

概要

主な機能

Content quality enforcement to remove ASCII art and persona-based roleplay
Directory structure and file naming integrity checks
Regex-based detection for deprecated command and agent invocation patterns
18 GitHub stars
Automated frontmatter validation for name, description, and metadata constraints
Strict line-limit monitoring to maintain a 500-line token budget

ユースケース

Validating new skill submissions before merging them into a marketplace
Refactoring existing skills to improve performance and reduce token consumption
Integrating quality gates into CI/CD pipelines for automated skill auditing