スキルリンター

スキルファイルを貼り付けて、タスクに結びつかない原因を突き止めます。

ファイルはブラウザー内で読まれます。社内の進め方を書いた手順が端末を離れることはありません。

新しいスキルを一から書く

スキルリンター について

まったく動かないスキルに構文の問題があることはまれです。読み込まれ、一覧にも並び、それでも選ばれない。説明文がいつ当てはまるかを書いていないか、誰も使わない言葉で書いているからです。この失敗は設計上まったくの無言で、エラーも警告も、何かがおかしいという合図も出ません。このリンターはローダーと同じようにファイルを読み、壊れている箇所を報告したうえで、ほとんどの注意を説明文に向けます。きっかけを名指ししているか、突き合わせに足る長さか、「これはスキルです」と繰り返して始まっていないか。ローダーが読まない項目も指摘します。キー名の打ち間違いは、正しいファイルとまったく同じ見た目だからです。

機能

• 本物の YAML パーサーでフロントマターを読み、失敗箇所を示します
• ローダーが読まない項目を指摘 — キーの打ち間違いはこう見えます
• 説明文のきっかけ句と長さを確認
• 説明文の文字数を上限と対比して表示
• 手順が「役に立たない長さ」を超えているかを確認
• エラーを提案より重く扱うスコア
• ファイルを置くか、貼り付けるか
• 何を検出するか見るための、わざと壊した例

スキルリンター の使い方

1. SKILL.md を置くか、中身を貼り付けます
2. 深刻なものから順に指摘を読みます
3. 説明文が挙がっていれば直します — そこが要です
4. スコアが澄むまで点検を繰り返します

例

入力

description: Helps with PDFs

出力

Warning: says what the skill is, but not when to use it

スキルが一度も選ばれない、最もよくある理由です。

よくあるエラーとトラブルシューティング

• フロントマターが無いと言われるが、確かにある。 — ハイフン三つが本当に最初の行でなければなりません。空行もコメントも、その上には何も置けません。
• 長い説明文で YAML が失敗する。 — コロンと空白を含む説明文は引用符で囲む必要があります。そうしないと YAML は別のキーとして読みます。
• 意図して使っている項目が指摘される。 — 未知の項目はエラーではなく注記です。ローダーは無視します。注記があるのは、綴りを誤ったキーが正しいキーと見分けがつかないからです。
• エラーが無いのにスコアが低いままだ。 — 警告も点を引きます。よくある組み合わせは、きっかけ句のない説明文と、短すぎる手順です。

よくある質問

スキルは読み込まれるのに、なぜ選ばれないのですか。

説明文はタスクと突き合わされます。主題だけを述べていると——「表計算を扱います」——依頼と一致させる手がかりがありません。状況、ファイル形式、人が使う言葉を名指しする句を足すだけで、たいていは解決します。

きっかけの句とは何を指しますか。

スキルが当てはまる瞬間を名指しするものです。「ユーザーが〜を求めたときに使う」「移行ファイルが変わったときは必ず」「〜に関わる作業では」。リンターはこの形を探し、見当たらなければ警告します。

説明文が長いのは良くないのですか。

それ自体は問題ありません。上限は寛容で、文字数も表示されます。困るのは、長いのに結局いつ使うかを述べていない説明文で、この組み合わせは驚くほどよく見かけます。

自分が書いていないスキルも点検できますか。

良い使い方です。よそから持ってきたスキルを置けば、その説明文が自分のスキルと競合するか、想定外のツールを宣言していないかがすぐに分かります。

結果が澄めばスキルは動きますか。

いいえ。ファイルが読み込まれ、説明文が突き合わせに使える形になっている、という意味です。手順が良いかどうかは、どのリンターも下さない判断です。

関連ツール

• スキルビルダー — SKILL.md を作成し、frontmatter を入力しながら検証します。
• サブエージェントビルダー — ツールとモデルを指定してサブエージェント定義ファイルを作ります。
• システムプロンプトリンター — 矛盾、効かない指示、未置換のプレースホルダーを見つけます。
• ツールスキーマ検証 — 定義を貼り付け、拒否される理由や誤呼び出しの原因を調べます。
• プロジェクト指示ビルダー — 毎リクエストの費用に見合う CLAUDE.md を書きます。
• スラッシュコマンドビルダー — 引数とツール許可リストを備えた独自コマンドを作ります。

AI・エージェントの他のツール

• スキルビルダー — SKILL.md を作成し、frontmatter を入力しながら検証します。
• サブエージェントビルダー — ツールとモデルを指定してサブエージェント定義ファイルを作ります。
• スラッシュコマンドビルダー — 引数とツール許可リストを備えた独自コマンドを作ります。
• プロジェクト指示ビルダー — 毎リクエストの費用に見合う CLAUDE.md を書きます。
• プラグインマニフェスト — plugin.json を生成し、前提となるフォルダ構成を確認します。
• フックビルダー — settings.json のフックを作り、発火しないマッチャーを見つけます。
• 権限ルールテスター — 許可・確認・拒否のルールを実際のコマンドで試します。
• MCP サーバー設定 — stdio、HTTP、SSE 向けの MCP サーバー設定を生成します。
• MCP ツールスキーマ — ツールを定義し、strict モードを検証した JSON Schema を得ます。
• ツールスキーマ検証 — 定義を貼り付け、拒否される理由や誤呼び出しの原因を調べます。
• プロンプトテンプレート展開 — 一つのプロンプトを行の表に展開し、欠けている値を確認します。
• システムプロンプトリンター — 矛盾、効かない指示、未置換のプレースホルダーを見つけます。
• プロンプト差分 — 二つの版を単語単位で比較し、トークン差も表示します。
• Few-shot 例ビルダー — 入出力の組をタグ付き、JSON、会話形式の例に変換します。
• XML プロンプト構成 — 内容が外に漏れないタグでプロンプトの各節を囲みます。
• JSONL ビューア・検証 — JSONL ファイルを行単位で読み、絞り込み、検証します。
• 会話ログ変換 — メッセージ配列を読みやすい記録に変換し、元にも戻します。
• 学習データ検証 — 学習を途中で止めるエラーがないか chat 形式の JSONL を調べます。
• SSE ストリームビューア — 生のストリーミング応答から本文、ツール呼び出し、使用量を取り出します。
• コンテキストウィンドウ設計 — ウィンドウをプロンプト、ツール、履歴、応答に配分します。
• プロンプトキャッシュ設計 — キャッシュできる接頭辞が最長になるようブロックを並べ替えます。
• テキスト分割 — 実際の切れ目で分かれる重なり付きのチャンクに文書を分けます。
• エージェントループ費用 — 再送される履歴とキャッシュを含めてターンごとに費用を見積もります。
• バッチリクエストビルダー — 行の表をバッチ処理に変換し、各リクエストに一意の ID を付けます。

AI・エージェントのツールをすべて見る · すべてのツール