Validate skill

Skill plaited/development-skills/skills/validate-skill

Make AI coding agents smarter. Type-aware code search, documentation standards, development conventions. CLI + installable skills for Claude, Cursor, Copilot.

Install

npx -y skills add plaited/development-skills --skill validate-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Validate skill directories against AgentSkills spec

The file declares its own license as ISC. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.5 KB, 599 tokens by cl100k_base, as published. Nobody here has run it

Validate Skill

Purpose

This skill validates skill directories against the AgentSkills specification. Use it to ensure your skills have proper frontmatter, required fields, and follow naming conventions.

Use when:

Creating new skills in any agent's skills directory (.claude/skills/, .cursor/skills/, etc.)
Reviewing PRs that modify skills
Validating skill structure before publishing

Scripts

validate-skill.ts

Validate one or more skill directories.

bunx @plaited/development-skills validate-skill [paths...]

Arguments:

paths: Paths to validate (defaults to current agent's skills directory)

Options:

--json: Output results as JSON

Examples:

# Validate skills in current directory's .claude/skills/
bunx @plaited/development-skills validate-skill .claude/skills

# Validate Cursor skills
bunx @plaited/development-skills validate-skill .cursor/skills

# Validate a specific skill
bunx @plaited/development-skills validate-skill .claude/skills/typescript-lsp

# Validate multiple paths with JSON output
bunx @plaited/development-skills validate-skill .claude/skills .cursor/skills --json

Validation Rules

Required Fields

name: Skill name (lowercase, alphanumeric with hyphens)
description: Brief description of the skill

Naming Conventions

Name must be lowercase
Only alphanumeric characters and hyphens allowed
Cannot start or end with hyphen
Cannot contain consecutive hyphens
Maximum 64 characters
Directory name must match skill name

Optional Fields

license: License identifier
compatibility: Runtime requirements
allowed-tools: Comma-separated list of allowed tools
metadata: Key-value pairs for additional metadata

Output Format

Human-Readable (default)

✓ .claude/skills/typescript-lsp
✓ .cursor/skills/my-skill
✗ .claude/skills/invalid-skill
  ERROR: Missing required field in frontmatter: 'description'

2/3 skills valid

JSON (--json)

[
  {
    "valid": true,
    "path": ".cursor/skills/my-skill",
    "errors": [],
    "warnings": [],
    "properties": {
      "name": "my-skill",
      "description": "..."
    }
  }
]

Related Skills

typescript-lsp - Example of a well-structured skill with scripts
code-documentation - TSDoc standards for TypeScript/JavaScript code