metadata-check

メタデータのチェック

文字数が重要な、短く価値の高い文字列をレビューします。タイトル、メタディスクリプション、スキーマの説明、FAQ の回答、タグライン、プロフィール、ソーシャルカードのコピーなどが対象です。Flesch スコアや 10 項目の可読性評価は、5～30 語の文字列には適していません。このスキルでは、適用できるチェックを行います。

メタデータ形式の文字列には、このスキルを使用してください。複数段落の文章（ブログ記事、README、CONTRIBUTING ファイル）には、代わりに readability-check を使用してください。

チェック項目

各文字列について、以下の項目を確認します。各項目の結果は、✓（合格）、⚠（要修正）、✗（問題あり）のいずれかです。

• 特徴を表す語を先頭に置く。 最も具体的で検索されやすい語を前方に配置します。「Astro SEO：決定版ガイド」は、「Astro SEO の決定版ガイド」よりも効果的です。読者の目にトピックが先に入るためです。
• 抽象的な表現より具体的な表現を使う。 名前、数値、具体的な主張を使います。「LCP を 40％削減」は、「パフォーマンスを大幅に改善」より効果的です。
• 冗長語や曖昧な表現は徹底的に削る。 どの語も表示スペースを使います。really、just、very、actually、basically、simply、a bit、kind of、I think は削除します。メタデータでは、こうした語は単なる文体の癖ではなく、SERP の文字数を無駄にします。
• 目的語が主語の場合を除き、能動態を使う。 「GitHub プロフィールを監査する」は、「GitHub プロフィールは監査できます」より効果的です。
• タイトルと説明の重複を避ける。 タイトルを繰り返すメタディスクリプションは、200 文字のうち約 60 文字を無駄にします。説明では、ページが何であるかを再び述べるのではなく、ページの中身を伝えます。
• 難しい語を避ける。 より一般的な同義語を使います。ただし、ユーザーが検索する専門用語は例外です。utilize より use を使います。対象読者に馴染みのある専門用語（hydration、middleware、structured data など）は問題ありません。
• SERP やプラットフォームの表示上限を考慮する。 表示先ごとの上限を把握してください。
  • Google SERP：タイトルは約 55～65 文字、説明は約 155～160 文字で省略されます。
  • GitHub リポジトリの説明：約 350 文字ですが、検索結果やプロフィールカードに表示されるのは最初の約 100 文字だけです。
  • Twitter/X のプロフィール文：160 文字です。
  • Open Graph の説明：約 200 文字まで表示されるのが一般的です。 省略される部分は、重要な約束を含めず、削除しても差し支えない内容にします。
• 項目ごとに要点を 1 つに絞る。 2 つのことを約束しようとするタイトルや説明は、焦点がぼやけます。最も明確な要点を選びます。

対象外

以下にはこのスキルを使用しないでください。

• URL、スキーマの @id 値、ファイル名、列挙値、その他の技術識別子。
• 複数段落の文章。readability-check に回してください。
• インポートされたコンテンツや上流の既定値など、ユーザーが作成しておらず、変更できない文字列。

出力形式

文字列ごとに、次の形式で返します。

### [Field name] — [length] chars

> [The string itself]

- Front-loading: [✓/⚠/✗] [one-line reason if not ✓]
- Concreteness: [✓/⚠/✗] [reason]
- Filler: [✓/⚠/✗] [reason]
- Active voice: [✓/⚠/✗] [reason]
- Duplication: [✓/⚠/✗] [reason]
- Word choice: [✓/⚠/✗] [reason]
- Truncation fit: [✓/⚠/✗] [reason] — platform: [SERP/GitHub/Twitter/OG]
- One idea: [✓/⚠/✗] [reason]

**Rewrite:** [only if any check failed — a concrete replacement string, not a suggestion]

監査結果は簡潔にまとめてください。メタデータへのフィードバックは、数秒で実行に移せる内容にします。また、通常は一度に複数の文字列を確認します。文字列に問題がなければ、説明を加えず、すべて✓と記して次に進みます。