Profile My skills Saved My plugins Edit profile Submit a skill

Meta Skill Lint

Validates every SKILL.md in .claude/skills/ for a well-formed YAML frontmatter with a non-empty description field, and flags duplicate skill names. Use when the user says "lint skills", "check skills", "validate SKILL.md", "skill health check", after installing a new skill, or before committing changes to .claude/skills/.

LucasGS520 Updated
Coding & Dev Tools

File contents

Skill Lint

Catches broken skills before they sit invisible in the repo — the exact failure mode found in this repo's cleanup: dev--security-auditor had no description: field and Claude Code could never activate it.

What it checks

For every .claude/skills/*/SKILL.md:

  1. File starts with a YAML frontmatter block (--- ... ---)
  2. Frontmatter has a description: field, non-empty
  3. name: field (if present) matches the folder name
  4. No two skills share the same name:

Usage

python .claude/skills/meta--skill-lint/scripts/lint.py

Exit code 0 = all clean. Exit code 1 = at least one broken skill, printed with the specific problem (missing frontmatter / missing description / name mismatch / duplicate name).

When something fails

  • Missing frontmatter / description: open the file, add a description: that states when to use the skill (trigger phrases help). See any other SKILL.md in the repo for the format.
  • Duplicate name: rename one of the two skills' name: field or folder.

Run this after adding any new skill, and before running meta--skill-audit (a skill audit is meaningless if some skills are silently broken).

LucasGS520/Claude-Codex-Skills/tree/main/.claude/skills/meta--skill-lint commit cd77f7c84b

Browse category

Frequently asked questions

npx skillmds@latest add lucasgs520/meta-skill-lint