mcpField
S
skill-check

skill-check

github.com/sickn33エージェントワークフロー48.7k99 回インストール今日更新
リポジトリ

skill-check について

SkillCheckは、agentskills仕様とAnthropicのベストプラクティスに照らしてSKILL.mdを確認する読み取り専用スキルです。構造、命名、意味上の問題を見つけたい作者やチーム向けで、完全なルールがない場合は定性的に評価します。

主な機能

  1. 01YAML frontmatterの解析
  2. 02構造、本文、命名の確認
  3. 03意味の一貫性と品質の検査
  4. 04スコアと問題レポートの作成
  5. 05単一のSKILL.mdのみを対象

活用シーン

  1. 01マーケットプレイス申請前のスキル確認
  2. 02スキルが起動しない原因の調査
  3. 03チームへのスキル作成基準の導入

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill skill-check

インストール後、Claude Code で/skill-checkを入力して読み込まれたか確認します。

詳細

SkillCheck

概要

agentskills 仕様および Anthropic のベストプラクティスに照らして、SKILL.md ファイルを検証します。構造上のエラー、意味的な矛盾、命名上のアンチパターン、品質の不足を、1 回の読み取り専用チェックで検出します。

このスキルを使用するタイミング

  • ユーザーが「check skill」「skillcheck」「validate SKILL.md」と言った場合に使用します
  • スキルをマーケットプレイスに公開する前のレビューに使用します
  • スキルが正しく起動しない原因をデバッグするときに使用します
  • チームにスキル作成基準を導入するときに使用します
  • アンチスロップ検出、セキュリティスキャン、トークン分析には使用しないでください。それらには SkillCheck Pro を使用してください

仕組み

ステップ 1：解析

対象の SKILL.md ファイルを読み込み、YAML フロントマターを抽出します。

ステップ 2：検証

このファイルにはチェックカテゴリの概要がありますが、完全な番号付きルールセットやバリデーターは含まれていません。正確なチェック ID、件数、スコアを示す場合は、実際の上流ルールまたはインストール済みのバリデーターを確認してください。このファイルしかない場合は、カテゴリごとの定性的なレビューを報告し、利用できないチェックは未評価としてください。

利用可能な Free tier のチェックを次の順に適用します。

カテゴリチェック検出する内容
構造（1.x）名前の形式、WHAT＋WHEN の説明、allowed-tools、カテゴリ、XML インジェクション不正なフロントマター、必須フィールドの欠落
本文（2.x）行数、ハードコードされたパス、古い日付、空のセクション、非推奨の構文、MCP ツールの修飾コンテンツ品質の問題
命名（3.x）曖昧な用語、単語 1 つだけの名前、動名詞の提案見つけやすさの問題
意味（4.x）矛盾、曖昧な用語、出力形式の欠落、教訓や決まり文句、トリガーの配置ミス論理上の矛盾
品質（8.x）例、エラー処理、トリガー、出力形式、前提条件、否定的トリガー強み（望ましいパターン）
ステップ 3：スコア算出

総合スコア（0～100）を算出します。減点：重大 = -20、警告 = -5、提案 = -1。

ステップ 4：レポート

スコア、評価（優秀／良好／要改善／不十分）、チェック ID、行番号、メッセージ、修正案を含む、構造化された結果を返します。

例

例 1：スキルの検証
User: check my skill at ~/.claude/skills/weekly-report/SKILL.md

SkillCheck output:
## weekly-report Check Results [FREE]

Score: 85/100 (Good)

### Warnings (2)
  - 1.2-desc-when (line 3): Description missing WHEN clause
  - 4.5-desc-no-triggers (line 3): Description lacks triggering conditions

### Suggestions (1)
  - 3.4-gerund-naming (line 2): Skill name could use gerund form

### Passed Checks: 28
例 2：問題のないスキルですべてのチェックに合格する
User: skillcheck ~/.claude/skills/processing-pdfs/SKILL.md

Score: 100/100 (Excellent)
All 31 checks passed. No issues found.

制限事項

  • 読み取り専用です。ファイルは変更しません
  • Free tier で対応するのは、構造、意味、命名のチェックのみです
  • アンチスロップ、セキュリティ、WCAG、トークン、エンタープライズ、ワークフローのチェックには SkillCheck Pro が必要です
  • 意味チェックはヒューリスティックです。このカタログの説明には、誤検出率を定量化できる評価の根拠は含まれていません。
  • 参照先のファイルやスクリプトは検証せず、SKILL.md の内容のみをチェックします
  • 単一ファイルの検証のみです。同じディレクトリ内のほかのスキルとの相互チェックは行いません

ベストプラクティス

  • スキルをマーケットプレイスに提出する前に SkillCheck を実行します
  • 重大な問題と警告はすべて修正します。提案への対応は任意です
  • チェック ID（例：1.2-desc-when）を使って、スキル本文内の該当するルールを特定します
  • 修正後に再実行し、スコアが向上したことを確認します

よくある落とし穴

  • 問題： 提案が多いためスコアが低く見える
    解決策： 提案による減点は合計 -15 点までです。まず警告と重大な問題に対処してください。

  • 問題： コードブロック内の曖昧な用語が誤検出される
    解決策： SkillCheck はコードブロックとインラインコードをスキップします。それでも誤検出される場合は、その用語をバッククォートで囲んでください。

  • 問題： 教訓や決まり文句のチェックで、正当な指示が検出される
    解決策： 一般的なアドバイス（「テストが重要であることを忘れないでください」）を、具体的な指示（「コミットする前にテストを実行してください」）に言い換えてください。

コメント

Markdown 対応