cdm skill

cdm skill サブコマンドで、SKILL.md を AIエージェント毎の所定の場所に配置します。

cdm skill <subcommand> [options]

サブコマンド	用途
skill install	SKILL.md をAIエージェントの所定の場所に配置

TIP

cdm skill が配置するのは、エージェントが cdm の対象ファイル（*.cnb.md / *.cann.yaml / *.ctag.yaml）を読む・編集すると判断したときに起動する SKILL.md です。必要なときだけ読み込まれるためコンテキストを節約できますが、起動はエージェントの判断に依存します。cdm を確実に利用させたい場合は、常時適用される連携方法の併用も検討してください。

配置先の指定

SKILL.md の配置先は、--agent（AIエージェント）と --scope（配置の起点 <root>）の組み合わせで決まります。いずれも未指定の場合は対話で選択します。

--scope で指定する <root> は次のとおりです。

--scope	<root>	用途
cwd	カレントディレクトリ	今いるディレクトリを起点に適用したい場合
repo	git リポジトリのルート （.git のある階層を探索）	リポジトリ全体に適用したい場合
user	ホームディレクトリ（~）	そのマシンの全プロジェクトに適用したい場合

--agent と --scope の組み合わせごとの配置先は次のとおりです。

--agent	--scope	配置先
claude-code	repo / cwd	<root>/.claude/skills/cdm/SKILL.md
claude-code	user	~/.claude/skills/cdm/SKILL.md
cursor	repo / cwd	<root>/.cursor/skills/cdm/SKILL.md
cursor	user	非対応
codex	repo / cwd	<root>/.agents/skills/cdm/SKILL.md
codex	user	~/.agents/skills/cdm/SKILL.md
antigravity	repo / cwd	<root>/.agents/skills/cdm/SKILL.md
antigravity	user	~/.gemini/config/skills/cdm/SKILL.md

• codex と antigravity は、repo / cwd では共通の .agents/skills を配置先とします。.agents/skills は複数のエージェントが共有する標準的な配置先です
• 対話時は、git リポジトリ内でない場合 repo は選択肢に表示されません（--scope repo をフラグで指定した場合は、git リポジトリが見つからなければ exit 1 で終了します）
• 表に記載のないエージェントは、--stdout で SKILL.md を出力し、エージェントの所定の場所へ手動で配置してください

SKILL.md の配置

cdm skill install
  --agent <name>    配置先のエージェント: claude-code | cursor | codex | antigravity（未指定時は対話で選択）
  --scope <scope>   配置スコープ: cwd | repo | user（未指定時は対話で選択）
  --dir <path>      `<root>` を直接指定（--scope と排他）
  --stdout          ファイルに配置せず、SKILL.md を標準出力に出力（--scope / --dir と排他）
  -y, --yes         確認プロンプトをスキップ

選択したエージェントの所定のパスに SKILL.md を配置します。配置先の詳細は 配置先の指定 を参照してください。

• --agent / --scope のいずれも、未指定の場合は対話で選択します
• 書き込み前に配置先の絶対パスを表示して確認します（--yes で確認をスキップ）。中間ディレクトリは必要に応じて自動作成します
• 既存の SKILL.md の内容が配置予定と同一の場合は書き換えず、異なる場合は上書きを確認します（--yes で上書き）
• cwd / repo を起点とする場合で、上位のディレクトリに既に cdm の SKILL.md があるときは、二重配置の可能性を警告します
• --dir <path> は、--scope の代わりに <root> を直接指定します。CI やスクリプトから配置先を明示したい場合に利用します
• --stdout は、ファイルに配置せず SKILL.md を標準出力に出力します。中身の確認やリダイレクトによる任意の場所への保存に利用できます

出力例

$ cdm skill install --agent claude-code --scope repo

Agent  claude-code
Scope  repo
Path   /Users/g0e/work/codatum/.claude/skills/cdm/SKILL.md

? Install SKILL.md? (Y/n)
✔ Installed (cdm vX.Y.Z)

利用例

# 対話でエージェント・スコープを選んで配置
cdm skill install

# Claude Code 向けに、リポジトリルートへ配置
cdm skill install --agent claude-code --scope repo

# Cursor 向けに、リポジトリルートへ配置（Cursor は user スコープ非対応）
cdm skill install --agent cursor --scope repo

# Codex 向けに、リポジトリへ配置（.agents/skills/ に配置）
cdm skill install --agent codex --scope repo

# Antigravity CLI 向けに、リポジトリへ配置（.agents/skills/ に配置）
cdm skill install --agent antigravity --scope repo

# `<root>` を明示し、確認なしで配置
cdm skill install --agent claude-code --dir ./path/to/root --yes

# 中身を確認する / 任意の場所に保存する
cdm skill install --stdout
cdm skill install --stdout > path/to/SKILL.md