Communitygithub.com

SamuelChien/mega-skills-collection

ウェブサイト、GitHubリポジトリ、ローカルドキュメント間のメッセージの一貫性を検証し、読み取り専用の不一致レポートを生成します。コンテンツの整合性確認やメッセージの混在を検出する際に使用します。「check consistency」「validate documentation」「audit messaging」などのフレーズで起動します。

mega-skills-collection とは?

Content Consistency Validatorは、複数のドキュメントソース(ウェブサイト、GitHubリポジトリ、ローカルドキュメント)間で、トーン、用語、フォーマット、構造の一貫性をチェックするAIエージェントスキルです。このスキルは、リリース前のバージョン監査やブランド変更後の用語統一チェック、オンボーディング時のドキュメントレビューなどに活用できます。ウェブサイトを最も信頼できるソースとして優先し、GitHub、ローカルドキュメントの順で信頼度を設定します。見つかった不一致は重大度(Critical、Warning、Informational)で分類され、ファイルパスや行番号を含む具体的な修正提案が読み取り専用のレポートとして出力されます。Claude Code、Cursor、Codexなどの主要なAIエージェントプラットフォームで動作し、WebFetchパーミッションとローカルファイルへのアクセス権限が必要です。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/000-jeremy-content-consistency-validator

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Content Consistency Validator(コンテンツ一貫性バリデーター)

概要

複数のドキュメントソース(ウェブサイト、GitHubリポジトリ、ローカルドキュメント)間で、トーン、用語、フォーマット、構造の一貫性をチェックします。重大度で分類された不一致と、ファイルパスや行番号を含む実行可能な修正提案を備えた読み取り専用レポートを生成します。

使用例

  • リリース前監査: 新バージョンのタグ付け前にバリデーターを実行し、README、ドキュメントサイト、変更履歴間のバージョン不一致(例:ウェブサイトではv2.1.0と表示されているが、GitHubのREADMEではv2.0.0のまま)を検出します。
  • ブランド変更後チェック: 製品名の変更や用語の更新(例:「plugin」を「extension」に変更)後、すべてのドキュメント、ランディングページ、コントリビューティングガイドで新しい用語が一貫して使用されていることを検証します。
  • オンボーディングレビュー: 新しいコントリビューターがドキュメントの混乱を報告した場合、一貫性チェックを実行して、矛盾する機能の主張、古い連絡先情報、ドキュメントソース間の欠落セクションを表面化します。

前提条件

  • 少なくとも2つのコンテンツソース(ウェブサイト、GitHubリポジトリ、またはローカルドキュメントディレクトリ)へのアクセス
  • リモートURL(デプロイ済みサイト、GitHub rawコンテンツ)用に構成されたWebFetchパーミッション
  • 認識可能なパス(docs/、claudes-docs/、internal/)に保存されたローカルドキュメント

手順

  1. ソースを発見 — ビルドディレクトリ(dist/、build/、public/、out/、_site/)、GitHubのREADME/CONTRIBUTINGファイル、ローカルドキュメントフォルダをスキャンします。
    find . -maxdepth 3 -name "README*" -o -name "CONTRIBUTING*" | head -20
    ls -d docs/ claudes-docs/ internal/ 2>/dev/null
    
  2. 各ソースから構造化データを抽出:バージョン番号、機能の主張、製品名、タグライン、連絡先情報、URL、技術要件。
    grep -rn 'v[0-9]\+\.[0-9]\+' docs/ README.md
    grep -rn -i 'features\|capabilities' docs/ README.md
    
  3. 抽出を確認 — ソースごとに少なくとも3つのデータポイントがあることを確認します。ソースが空を返した場合は、続行する前にエラーハンドリングの表を確認します。
  4. 比較マトリックスを構築 — 各ソースを他のすべてのソースとペアにして比較します(ウェブサイト vs GitHub、ウェブサイト vs ローカルドキュメント、GitHub vs ローカルドキュメント)。
    diff <(grep -i 'version' README.md) <(grep -i 'version' docs/overview.md)
    
  5. 不一致を重大度で分類:
    • Critical: 矛盾するバージョン番号、相反する機能リスト、不一致の連絡先情報、壊れた相互参照
    • Warning: 一貫性のない用語(例:「plugin」と「extension」)、1つのソースでの情報欠落、古い日付
    • Informational: スタイルの違い、プラットフォーム固有の表現、異なる詳細レベル
  6. 信頼度優先順位を適用: ウェブサイト(最も信頼できる) > GitHub(開発者向け) > ローカルドキュメント(内部用)。
  7. レポートをMarkdownとして生成: エグゼクティブサマリー、ペアごとの比較表、用語一貫性マトリックス、ファイルパスと行番号付きの優先順位付けされたアクションアイテムを含みます。
  8. consistency-reports/YYYY-MM-DD-HH-MM-SS.md に 保存します。

レポート形式

# 一貫性レポート — YYYY-MM-DD

## エグゼクティブサマリー
| 重大度 | 件数 |
|----------|-------|
| Critical | 2     |
| Warning  | 5     |
| Info     | 3     |

## ウェブサイト vs GitHub
| フィールド    | ウェブサイト   | GitHub        | 重大度 |
|-------------|---------------|---------------|----------|
| バージョン    | v2.1.0        | v2.0.0        | Critical |
| 機能X   | 記載あり       | 欠落          | Warning  |

## アクションアイテム
1. **Critical** — `README.md:14` のバージョンを v2.0.0 → v2.1.0 に更新
2. **Warning** — 「機能X」を `README.md` の機能リストに追加

エラーハンドリング

エラー原因解決策
ウェブサイトのコンテンツにアクセス不可URLが4xx/5xxを返す、またはビルドディレクトリが存在しないサイトがデプロイされているか確認するかローカルビルドを実行。WebFetchパーミッションを確認
GitHub APIレート制限短時間に大量のフェッチを実行リセットウィンドウ後に一時停止して再試行。認証済みリクエストを使用
ドキュメントディレクトリが存在しない期待されるパスが存在しない作業ディレクトリを確認。ドキュメントパスを明示的に指定
コンテンツ抽出が空クライアントサイドレンダリングがフェッチで表示されないライブURLの代わりにローカルビルド出力ディレクトリを使用
diffコマンドの失敗ファイルパスに特殊文字が含まれているdiffやgrepに渡すすべてのファイルパスを引用符で囲む

リソース

  • コンテンツソース発見ロジック: ${CLAUDE_SKILL_DIR}/references/how-it-works.md
  • 信頼度優先順位と検証タイミング: ${CLAUDE_SKILL_DIR}/references/best-practices.md
  • ユースケースウォークスルー: ${CLAUDE_SKILL_DIR}/references/example-use-cases.md

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Create forensically sound bit-for-bit disk images using dd and dcfldd while preserving evidence integrity through hash verification.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

関連スキル