cocoindex-setup/skills/cocoindex-setup/SKILL.md
CocoIndex 共通の secrets/config ディレクトリ(~/.config/cocoindex/)の auto-provision 手順。複数プラグインの secrets hub として機能し、compass / episodic が fallback で参照する。
npx skillsauth add hidetsugu-miya/claude-plugins cocoindex-setupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
~/.config/cocoindex/ の以下 2 ファイルを所有・auto-provision する:
~/.config/cocoindex/secrets.env — VOYAGE_API_KEY 等の API キー~/.config/cocoindex/config.toml — 共通既定値(DB URL / embedding / chunk / rerank 等)このディレクトリは複数プラグイン共通の secrets hub として機能する。compass / episodic などの下流プラグインは、
~/.config/<plugin>/secrets.env(プラグイン専用、最優先)~/.config/cocoindex/secrets.env(このプラグインが所有、fallback)の順で読み込む。プラグイン専用 secrets.env を空にしておけば、本ファイルから自動 fallback される。
compose.yml / DB 起動は別プラグイン
pgvector-stackが担う。本プラグインはコンテナ管理を行わない。
pgvector-stack プラグイン(PostgreSQL コンテナ提供)
/plugin install pgvector-stack@hidetsugu-miyabash ${CLAUDE_PLUGIN_ROOT}/scripts/check_config.sh
不足ファイルだけテンプレートからコピーする(既存ファイルは上書きしない)。
mkdir -p ~/.config/cocoindex
cp ${CLAUDE_PLUGIN_ROOT}/templates/secrets.example.env ~/.config/cocoindex/secrets.env
cp ${CLAUDE_PLUGIN_ROOT}/templates/config.example.toml ~/.config/cocoindex/config.toml
chmod 700 ~/.config/cocoindex
chmod 600 ~/.config/cocoindex/{secrets.env,config.toml}
配置後、~/.config/cocoindex/secrets.env の VOYAGE_API_KEY を設定する。
下流プラグイン(compass / episodic)から見た優先順位(強い順):
~/.config/<plugin>/secrets.env または ~/.config/<plugin>/.env(プラグイン専用)~/.config/<plugin>/cocoindex.toml(プラグイン専用、ある場合)~/.config/cocoindex/secrets.env(このプラグイン所有)~/.config/cocoindex/config.toml(このプラグイン所有)[database].url — Postgres 接続先(プラグインが専用 DB URL を持たない場合の fallback)[embedding].provider / .model / .dimension — voyage / openai / ollama[chunk].size / .overlap — RecursiveSplitter パラメータ[rerank].enabled / .model / .candidates — voyage rerank 設定[live].update_interval_seconds — LiveUpdater 更新間隔[embed].prefix_filepath — 埋め込みにファイルパス prefix を付与詳細は templates/config.example.toml を参照。
VOYAGE_API_KEY 未設定 → compass / episodic の embedding 実行が 401 で失敗する。~/.config/cocoindex/secrets.env に設定する~/.config/<plugin>/secrets.env で override されていないか確認するtools
Slack MCP CLI の初期セットアップ skill。`~/.config/slack/bin/slack-mcp` wrapper を作成し、Codex / Claude / terminal から `CLAUDE_PLUGIN_ROOT` なしで Slack MCP を使えるようにする。「Slack MCP をセットアップ」「slack-mcp コマンドを作成」等で起動する。
tools
Slack MCP 連携の共通リファレンス。公式 MCP Python SDK、固定 Slack CLIENT_ID、ワークスペース単位の OAuth token 保存、Slack MCP CLI の実行規約を定義する。slack-connect / slack-bridge から参照する。
tools
Slack MCP 用の初回接続 skill。`~/.config/slack/bin/slack-mcp login` で公式 MCP Python SDK による OAuth 認証を実行し、ワークスペース単位で token を保存する。「Slack を接続」「Slack MCP の初回登録」等で起動する。
tools
登録済み Slack workspace を使って Slack MCP tool を実行する skill。`~/.config/slack/bin/slack-mcp call` 方式で、検索・チャンネル履歴・スレッド取得・送信を行う。「Slack を検索」「Slack の permalink を読んで」「Slack チャンネル履歴を見て」等で起動する。