skill-lint

Validate SKILL.md frontmatter and directory names for consistency.

5|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/gabrielkoerich/skills --skill skill-lint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-lint
Source: https://github.com/gabrielkoerich/skills/tree/main/skill-lint
Command: npx skills add https://github.com/gabrielkoerich/skills --skill skill-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires rg, and includes scripts (resource) components.

What problem does it solve?

This Skill automatically validates and normalizes skill directories to ensure consistent metadata, proper naming, and validation of required files, reducing setup errors and drift across a repo.

Core Features & Use Cases

  • Metadata validation: Ensures every skill has SKILL.md frontmatter with name and description.
  • Naming and placeholders: Checks directory-name against the frontmatter name and enforces placeholder consistency with <project-name>.
  • Auto-fix support: Offers a --fix mode to automatically correct issues where safe to do so.
  • Optional checks: Warns when agents/openai.yaml is missing to surface configuration gaps.

Quick Start

Run the lint-skills.sh script to validate and auto-fix all skills in the repository.

Frequently Asked Questions about skill-lint

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

FAQPage Schema
How do I validate SKILL.md frontmatter metadata across a repository?

You can validate SKILL.md frontmatter metadata by running a lint script that checks every skill directory for required name and description fields, ensuring naming consistency and proper placeholder usage to reduce setup errors and drift.

How do I automatically fix skill directory naming inconsistencies?

To automatically fix skill directory naming inconsistencies, execute the lint script with the --fix mode. This corrects mismatches between directory names and frontmatter metadata names, applying safe, deterministic auto-fixes to normalize your skills repository.

Can I run skill metadata validation in a CI pipeline?

Yes, you can run skill metadata validation in a CI pipeline. The lint script provides a safe, deterministic workflow that detects missing agents/openai.yaml files and improper placeholder usage, making it suitable for continuous integration or local runner execution.

What is skill frontmatter linting and when do I need it?

Skill frontmatter linting is the process of validating and normalizing metadata in SKILL.md files to ensure required fields exist and match directory names. You need it to reduce setup errors and prevent configuration drift across a skills repository.

Do I need ripgrep installed to lint skill metadata?

Yes, you need ripgrep installed to lint skill metadata. The validation script depends on the rg command to search and identify metadata inconsistencies, missing required files, and improper placeholder usage across skill directories efficiently.