validate-skill

スキルの検証

目的

このスキルは、スキルディレクトリがAgentSkills仕様に準拠しているか検証します。スキルに適切なフロントマターと必須フィールドがあり、命名規則に従っていることを確認するために使用します。

次の場合に使用します：

• エージェントのスキルディレクトリ（.claude/skills/、.cursor/skills/など）に新しいスキルを作成するとき
• スキルを変更するPRをレビューするとき
• 公開前にスキルの構造を検証するとき

スクリプト

validate-skill.ts

1つ以上のスキルディレクトリを検証します。

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

引数：

• paths：検証するパス（デフォルトは現在のエージェントのスキルディレクトリ）

オプション：

• --json：結果をJSON形式で出力します

例：

# 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

検証ルール

必須フィールド

• name：スキル名（小文字、英数字とハイフン）
• description：スキルの簡潔な説明

命名規則

• 名前は小文字である必要があります
• 使用できるのは英数字とハイフンのみです
• ハイフンで始めたり終えたりすることはできません
• ハイフンを連続して使用することはできません
• 最大64文字です
• ディレクトリ名はスキル名と一致する必要があります

任意フィールド

• license：ライセンス識別子
• compatibility：ランタイム要件
• allowed-tools：許可するツールのカンマ区切りリスト
• metadata：追加メタデータのキーと値のペア

出力形式

人間が読みやすい形式（デフォルト）

✓ .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": "..."
    }
  }
]

関連スキル

• typescript-lsp - スクリプトを含む、適切に構成されたスキルの例
• code-documentation - TypeScript/JavaScriptコードのTSDoc標準