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

•

Developer Tools

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.

Key Features

01Content quality enforcement to remove ASCII art and persona-based roleplay

02Directory structure and file naming integrity checks

03Regex-based detection for deprecated command and agent invocation patterns

0418 GitHub stars

05Automated frontmatter validation for name, description, and metadata constraints

06Strict line-limit monitoring to maintain a 500-line token budget

Use Cases

01Validating new skill submissions before merging them into a marketplace

02Refactoring existing skills to improve performance and reduce token consumption

03Integrating quality gates into CI/CD pipelines for automated skill auditing

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add majesticlabs-dev/majestic-marketplace skill-linter

For use in Claude.ai and ChatGPT

Download Skill