> For the complete documentation index, see [llms.txt](https://getsquish.gitbook.io/squish/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://getsquish.gitbook.io/squish/ja/reshipi/agent-skill.md).

# エージェントスキルをインストール

この **`video-navigation`** スキルは、そのまま差し込めるプロトコル文書で、エージェントに一連の実践手順を教えます。取り込めない動画を渡されたら、タイムスタンプ付きの Contact Sheet に圧縮し、グリッドを読み取り、範囲を拡大して `開始`/`終了` 推測するのではなく、引用する前に確認し、絶対タイムコードで回答します。スキルをインストールしたエージェントは、自分で Squish を使います。プロンプトでワークフローを説明する必要はありません。オープン [エージェントスキル](https://agentskills.io) 形式なので、これを取り込むあらゆるエージェントで動作します。 `SKILL.md` スキル。

## 配置場所

[`skills/video-navigation/SKILL.md`](https://github.com/getsquish/squish/tree/main/skills/video-navigation/README.md) の [github.com/getsquish/squish](https://github.com/getsquish/squish)にあります。frontmatter で独自の要件を宣言しています。必要なのはコンタクトシートツール、つまりローカルの Squish CLI/MCP（Node ≥ 20、 `ffmpeg` が PATH 上にあること）またはホスト型コネクタです。

## skills CLI でインストールする（推奨）

1つのコマンドで、Claude Code、Cursor、Codex、その他すべてのエージェントに対応し、 [`skills` CLI](https://github.com/vercel-labs/skills) が対応しています：

```bash
npx skills add getsquish/squish
```

## 手動でインストールする（Claude Code）

Claude Code は skills を `SKILL.md` skills ディレクトリ内のファイルとして検出します。ファイルを、そのスキル名のフォルダにコピーします：

```bash
mkdir -p ~/.claude/skills/video-navigation
curl -o ~/.claude/skills/video-navigation/SKILL.md \
  https://raw.githubusercontent.com/getsquish/squish/main/skills/video-navigation/SKILL.md
```

プロジェクトの `.claude/skills/` ディレクトリを、 `~/.claude/skills/` の代わりに使用すると、スキルを 1 つのリポジトリに限定できます。スキルの `description` frontmatter は、いつ起動するかをエージェントに伝えます。これ以上の配線は不要です。次と組み合わせると、 [MCPサーバー](/squish/ja/hajimeni/quickstart-mcp.md) 最もスムーズに使えます。スキルは `squish_video` ツールが利用可能な場合はそちらを優先し、利用できない場合は CLI を次で実行するフォールバックに切り替えます： `npx`.

## その他の場所にインストールする

このファイルは小さな YAML frontmatter を含む通常の Markdown です。フレームワーク固有の内容はありません。ほかのエージェントフレームワークでは、そのフレームワークが skill/instruction ファイルを読み込む場所に置くか、本体をエージェントの system prompt またはカスタム指示に貼り付けてください。実際の要件はスキルに記載されたものだけです。エージェントには vision に加えてコンタクトシートツールが必要であり、shell access（Node ≥ 20、 `ffmpeg`）または `squish_video` MCP ツールです。

## 実例：Hermes

このスキルの派生版は、Hermes エージェントフレームワーク向けにも提供されています（`squish-video`は、このプロジェクトの統合ドキュメントに記載されています）。そこにある 2 つの慣習は、派生させるどのスキルにも取り入れる価値があります：

**固定された回答形式です。** Hermes のスキルでは、ファイルパスだけで回答することが禁止されており、応答構造が次のように定められています：

1. **概要** — クリップの内容を 1〜2 文で説明します。
2. **タイムスタンプ付きの重要な場面** — 重要な出来事を、それぞれセルのタイムコードで引用します。
3. **注目すべきフレーム / 異常** — 不自然な点とそのタイムコード、あるいは該当なしと記します。

また、ユーザーの質問が具体的（「…の瞬間を見つけて」など）であれば、その答えとタイムスタンプを先に示します。これにより、「エージェントがシートを作成した」から「エージェントが質問に答えた」へ変わります。

**明示的な対象範囲です。** 対象はローカルの動画ファイルパスに限定しています。動画がチャット添付ファイルや URL の場合は、最初にローカルパスを求めます。質問が動画の視覚的内容に関するものでない場合は、手順全体を省略します。

## エージェントが使うべき場面 — 使わない場面

動画が長すぎる、または大きすぎて直接取り込めない場合、質問が時間にまたがる場合（前後、場面転換、進捗、「…の瞬間を見つけて」など）、あるいは正確な引用が必要な場合（「0:07 でプレスが下がる」など）に、このスキルを使います。

ユーザーが 1 枚の特定フレームだけを必要としている場合（そのフレームを直接抽出してください）、またはフレームの証拠や動作タイミングから答えられない場合は、使いません。ローカル版 Squish 0.3 以降では、ナビゲーション信号として音声アクティビティが追加されますが、音声認識や音の解釈ではありません。こちらの [FAQ](/squish/ja/rissu/faq.md) 口の動きごとの境界については、こちらを参照してください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://getsquish.gitbook.io/squish/ja/reshipi/agent-skill.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.