メインコンテンツまでスキップ

link

フォルダ（自分の Skill のチェックアウトなど）を Skill の source の直下にリンクします。follow_source_links を有効にすると、skillshare はその中の Skill を一覧表示し、sync します。

skillshare link ~/code/dev-skills                  # _dev-skills としてリンク
skillshare link ~/code/dev-skills --enable         # リンクしてたどる設定を有効化
skillshare link ~/code/dev-skills --name _mine     # リンク名を指定
skillshare link ../team --name _team -p            # project の source にリンク
skillshare link -- -checkout                       # - で始まるパスをリンク

使うタイミング​

  • Skill のチェックアウトをコピーとしてインストールせず、今ある場所で編集し続ける
  • 外部ドライブ上の Skill を使う
  • Windows で、ジャンクションと symlink のどちらにするかを自分で選ばずにリンクを作成する
$ skillshare link ~/code/dev-skills --enable
✓ Linked _dev-skills → ~/code/dev-skills · symlink
✓ Set follow_source_links: true ~/.config/skillshare/config.yaml

Next
  skillshare sync  link its skills into your targets

実行内容​

  1. リンク名のデフォルトは _ とフォルダ名です（_dev-skills）。source の直下にある単一の名前でなければなりません。
  2. discovery がたどるリンクを確認するのと同じ方法でフォルダを確認します。名前が既に存在する場合、またはフォルダが source 自体やその親である、source の内部にある、sync target と重なる、存在しない、読み取れない、ディレクトリではない場合、リンクは拒否されます。
  3. リンクを作成します。macOS と Linux では絶対パスの symlink です。Windows ではジャンクションを作成し、開発者モードも管理者権限も不要です。ジャンクションの作成に失敗した場合にのみディレクトリ symlink を試します。
  4. フォルダに .git エントリがない場合は警告が表示されます。リンクは機能しますが、skillshare update で pull することはできません。
  5. follow_source_links が無効の場合、--enable を付けない限り config は変更されません。付けない場合、skillshare doctor と同じヒントが表示されます。--enable で config を保存できない場合、作成したリンクは削除されてコマンドは失敗するため、たどられないリンクは残りません。ダッシュボードの Link folder のチェックボックスも同じです。

オプション​

フラグ説明
--name <name>source 内のリンク名（デフォルト: _<フォルダ名>）
--enablefollow_source_links: true も設定
--project, -pカレントディレクトリの project レベルの config を使用
--global, -gglobal config を使用（~/.config/skillshare）
--オプションの終わり。- で始まるパスを指定できる
--help, -hヘルプを表示

--enable を付けない場合​

$ skillshare link ~/code/dev-skills
✓ Linked _dev-skills → ~/code/dev-skills · symlink
! target is not a git checkout; skillshare update cannot pull it
  _dev-skills: not followed by discovery; its contents are invisible to skillshare. Set follow_source_links: true to follow it

リンクは作成されていますが、config で follow_source_links: true が設定されるまで discovery はそれを無視します。

拒否されるリンク​

コマンドは非ゼロで終了し、何も作成しません。

$ skillshare link ~/.claude
✗ cannot link /home/me/.claude: target overlaps sync target /home/me/.claude/skills
理由原因
target is the source or a parent of itたどると source 自体に戻ってしまう
target is inside the sourceその Skill は既に source にある
target overlaps sync target <path>フォルダが有効な skills target そのものである、それを含む、またはその中にある
target is a link chain that could not be resolvedパスがリンクで、そのリンク先を解決できない
target is missing / target is not readable / target is unavailable: <error>フォルダが存在しないか、読み取れない
target is not a directoryパスがファイルである
<name> already existssource に同じ名前のものが既にある
"<name>" is not a first-level name--name にパス区切り文字が含まれている、または . / .. である

手動のリンク​

skillshare link が作成するエントリは、自分で作成したリンク（ln -s、Windows では mklink /J）と同じもので、discovery は両者を同じように扱います。このコマンドは、作成前に上記のチェックを加えるだけです。

関連項目​