❄️

Cotex Code CLI Remote Skill 機能を試したい

2026/04/25に公開

概要

Snowflake Cortex Code CLI には、 Remote Skill という機能が備わっています。

この機能によると、 Gitリポジトリから、ローカルの Cortex Code CLI 環境に Skill を追加できるようです。

これを試します。

動作環境は WSL2 (Ubuntu)。

以下のようなディレクトリ構成を想定

repository-top
└─ skills/
    ├── my-skill-1
    │   └── SKILL.md
    ├── my-skill-2
    │   └── SKILL.md
    └── my-skill-3
        └── SKILL.md

skills 以外にも、スキルを管理するディレクトリが複数存在していても問題ない。

cortex skill add コマンドにて追加する。

cortex skill add <github 組織名>/<リポジトリ名>/<skill格納ディレクトリ>

前提条件に当てはめると、以下のようなコマンドになる。

cortex skill add my_organizations/repository-top/skills

追加した skill は、以下のコマンドで確認する。

cortex skill list

追加に成功している場合、 Remote Skills: 欄に情報が追加される。

パスの後に、#ブランチ名 と続ける。

cortex skill add <github 組織名>/<リポジトリ名>/<skill格納ディレクトリ>#ブランチ名

前提条件に当てはめると、以下のようなコマンドになる。

cortex skill add my_organizations/repository-top/skills#main

cortex skill add my_organizations/repository-top/skills#my_test_skills_branch

skills/追加したいSkill名と続ける。

cortex skill add <github 組織名>/<リポジトリ名>/<skill格納ディレクトリ>/<配下のSkillディレクトリ>#ブランチ名

前提条件に当てはめると、以下のようなコマンドになる。

cortex skill add my_organizations/repository-top/skills/my-skill-1#main

以下のコマンドで削除する。

cortex skill remove github:<github 組織名>/<リポジトリ名>#<リポジトリのブランチ名>

前提条件に当てはめると、以下のようなコマンドになる。

cortex skill remove github:my_organizations/repository-top#main

追加した Skill は、 ~/.snowflake/cortex/ 配下に格納される。
つまり、Linux ユーザー単位で追加される。

./.cortex のように、特定のプロジェクトにのみ追加する方法は、現時点(2026/04/25)では不明。

Remote Skill の仕様を調査するにあたって最も重宝したのは Cortex Code CLI 自身でした。

Cortex Code CLI 自身に、 Remote Skill に関することを質問すると、Cortex Code 自身がホストしているであろうSkillの中身を確認しているようでした。

そこから、 Remote Skill に関する仕様や cortex コマンドのヘルプ情報などを拾い上げ、適切なコマンドを組み立ててくれました。

Cortex Code CLI 周りで不明点や調査したいことがあれば、 Cortex Code CLI に直接確認を取るのが手っ取り早そうです。