インストール

contextlint は 2 種類のインストール方法 を提供しています。AI ホスト（Claude Code / Cursor / Codex 等）を使っているなら Skill 経由が最短 です。それ以外は CLI 経由 で手動セットアップします。

Skill 経由（推奨）

agentskills.io 互換の AI ホストを使っているなら、gh skill install 一発で完了します。

gh skill install nozomi-koborinai/contextlint contextlint-init

その後、AI に次のように頼むだけです。

contextlint を設定して

AI がリポジトリの構造を分析し、ドキュメントの配置・スタイル（ADR 形式 / 仕様書形式 / テーブル中心 / 等）を読み取って、プロジェクトに合った contextlint.config.json を自動生成します。21 個あるルールから手で選ぶ必要はありません。

対応する AI ホスト:

前提: GitHub CLI (gh) がインストール済みであること。未インストールの場合は GitHub CLI 公式サイトを参照してください。

AI ホストを使っていない、または設定を完全に自分で管理したい場合は、@contextlint/cli パッケージを直接インストールします。

contextlint は npm レジストリで配信されています。プロジェクトのパッケージマネージャーに合わせて以下のいずれかを実行してください。

# bun
bun add -D @contextlint/cli

# pnpm
pnpm add -D @contextlint/cli

# yarn
yarn add -D @contextlint/cli

# npm
npm install -D @contextlint/cli

開発依存（-D または --save-dev）として追加することを推奨します。本番ビルドには不要なためです。

複数プロジェクトで頻繁に使う場合はグローバルインストールも可能です。

# bun
bun add -g @contextlint/cli

# npm
npm install -g @contextlint/cli

ただし、プロジェクトごとに依存バージョンを固定したい場合は プロジェクト内インストール（-D）の方が安全 です。CI 環境でも同じ動作を保証できます。

インストール後、バージョンを表示できれば成功です。

npx contextlint --version