tagru skill

AI エージェント（Claude Code / Codex）が tagru を使うための skill（SKILL.md）を入れる・表示する・削除します。使い方の流れは AI エージェントから使うを参照してください。

text

tagru skill install [--agent <claude|codex|all>] [--project] [--yes] [--json]
tagru skill show
tagru skill uninstall [--agent <claude|codex|all>] [--project] [--json]

skill は CLI に同梱した、CLI と同じバージョンのものです。ネットワークからは取得しません。ログインは不要です。

サブコマンド

サブコマンド	内容
`install`	同梱の `SKILL.md` を AI エージェントの skill のディレクトリに入れる
`show`	同梱の `SKILL.md` を標準出力に出す
`uninstall`	入れた `SKILL.md` を削除する

オプション

オプション	内容
`--agent <name>`	入れる先のエージェント。`claude`（既定）/ `codex` / `all`（両方）
`--project`	ホームディレクトリではなく、今のディレクトリに入れる（削除する）
`--yes`	内容の違う skill が既にあるとき、確認せずに上書きする。`install` のみ
`--json`	JSON で出力する（`show` を除く）

--target / --workspace は使いません。

入れ先

`--agent`	既定（ホームディレクトリ）	`--project`（今のディレクトリ）
`claude`	`~/.claude/skills/tagru/SKILL.md`	`./.claude/skills/tagru/SKILL.md`
`codex`	`~/.codex/skills/tagru/SKILL.md`	`./.codex/skills/tagru/SKILL.md`
`all`	上の両方	上の両方

使い方

bash

tagru skill install                    # ~/.claude/skills/tagru/SKILL.md に入れる（Claude Code）
tagru skill install --agent codex      # ~/.codex/skills/tagru/SKILL.md に入れる（Codex）。all で両方
tagru skill install --project          # 今のディレクトリの .claude/skills/tagru/ に入れる（Codex なら .codex/skills/tagru/）
tagru skill show > SKILL.md            # 同梱の SKILL.md を標準出力に出す（好きな場所に保存できる）
tagru skill uninstall                  # 入れた SKILL.md を削除する（--agent / --project は install と同じ）

text

$ tagru skill install
入れました: /home/user/.claude/skills/tagru/SKILL.md

$ tagru skill install
同じ内容が入っています（変更なし）: /home/user/.claude/skills/tagru/SKILL.md

$ tagru skill uninstall --agent all
削除しました: /home/user/.claude/skills/tagru/SKILL.md
削除しました: /home/user/.codex/skills/tagru/SKILL.md

既に同じ内容があるときは何もしません。内容が違うときは上書きしてよいか確認します（--yes で確認なし）
- 端末でない環境（パイプ・AI エージェントからの実行など）で --yes が無い場合は、上書きせずに終了コード 1 で終わります
- 確認はすべての入れ先について書き込む前に行います。エラーで止まる場合はどこにも書き込みません
uninstall は SKILL.md だけを削除します。skills/tagru/ に他のファイルがあれば、ディレクトリは残します
uninstall は、入っている SKILL.md を内容にかかわらず確認なしで削除します（手で編集した場合も削除されます）
入れ先がシンボリックリンクの場合、install はリンク先のファイルに書き込み、uninstall はリンク自体を削除します（リンク先は残ります）
入れ先の起点（ホームディレクトリ・今のディレクトリ）が絶対パスでない場合（環境変数 HOME が空など）は、何もせずに終了コード 1 で終わります
CLI を更新したら、もう一度 tagru skill install を実行すると skill も新しいバージョンになります（内容が変わっていれば上書きの確認が出ます）

`--json`（install / uninstall）

tagru skill --json は一覧・詳細の外枠（target / workspaceId）を使わず、item だけを出します。

jsonc

{
  "item": {
    "paths": ["/home/user/.claude/skills/tagru/SKILL.md"],  // install: skill が入っている場所 / uninstall: 削除した場所
    "results": [
      { "agent": "claude", "path": "/home/user/.claude/skills/tagru/SKILL.md", "status": "created" }
    ]
  }
}

項目	型	内容
`paths`	string[]	install: 処理後に skill が入っている場所（`created` / `updated` / `unchanged`）。uninstall: 削除した場所
`results[]`	object[]	入れ先ごとの結果 `{ agent, path, status }`（`agent` は `claude` / `codex`）

`status`	内容
`created`	新しく入れた
`updated`	上書きした
`unchanged`	同じ内容が既に入っていた
`skipped`	上書きの確認で「いいえ」と答えた
`removed`	削除した（uninstall）
`not_found`	入っていなかった（uninstall）

tagru skill ​

サブコマンド ​

オプション ​

入れ先 ​

使い方 ​

--json（install / uninstall） ​

tagru skill

サブコマンド

オプション

入れ先

使い方

`--json`（install / uninstall）