> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# スキル

> 再利用可能なステップバイステップのワークフローをShanoneに一度保存すれば、どのマシン・IDE・エージェントからでも再利用できます。

## Skillとは何か

**Skill**とは、名前付きの再利用可能な指示セットのことで、コンセプトとしては[AnthropicのAgent Skills](https://www.anthropic.com/news/skills)に近いものです。各Skillは3つのフィールドを持ちます。

| フィールド          | 用途                                           | 上限          |
| -------------- | -------------------------------------------- | ----------- |
| `name`         | 短く分かりやすいタイトル                                 | 1〜200文字     |
| `summary`      | Skillが何を行い、いつ使うべきかを示す説明 — 一覧結果に表示される軽量なメタデータ | 最大2,000文字   |
| `instructions` | ステップバイステップの完全な本文 — Skillが実際に開かれたときにのみ取得される   | 最大100,000文字 |

Shanone自身がSkillを*実行する*ことは決してありません。**Skill Vendor**は保存と取得だけを担うレイヤーです。エージェントはMCP経由でSkillを一覧表示・読み取りし、自身のコンテキストの中で`instructions`に従い、その過程で必要に応じて`shanone_execute_tool`(や他に必要なもの)を呼び出します。これによってSkillは、それを読み取るエージェントが何であっても——今日はCursor、明日はClaude Code、来週は別のノートPCでも——持ち運び可能な状態を保てます。

<Note>
  Skillはローカルファイルではなく、サーバー側(ShanoneのSkill Vendorバックエンド)に保存されます。一度保存すれば、あなたのアカウントが接続するあらゆる場所で利用できます。Skillはチームで共有されるものではなく、ユーザー単位で管理されます——Shanone全体へのアクセス管理については[権限管理とアクセス制御](/ja/product-guide/permissions)を参照してください。
</Note>

## Skillが存在する理由

<CardGroup cols={2}>
  <Card title="繰り返しをなくす" icon="repeat">
    同じ複数ステップの指示を一度だけ伝えて保存し、以降は名前で参照するだけで済みます
  </Card>

  <Card title="エージェント間で持ち運び可能" icon="laptop">
    Cursorで作成したSkillは、Claude Codeや、あなたのアカウントに接続する他のどのMCPクライアントからもすぐに読み取れます
  </Card>

  <Card title="段階的な開示" icon="layers">
    Skillの一覧表示では軽量なメタデータ(`name`と`summary`)のみが返され、完全な`instructions`はSkillが実際に開かれたときにのみ取得されるため、トークン使用量を低く抑えられます
  </Card>

  <Card title="Webダッシュボードとも共有される" icon="globe">
    MCP経由で作成したSkillは、Shanoneの Web UIの**Skills**にも表示されます。逆方向も同様です
  </Card>
</CardGroup>

## Skill Vendorのツール

| ツール                    | 説明                                              |
| ---------------------- | ----------------------------------------------- |
| `shanone_list_skills`  | 保存済みのSkillを一覧表示(メタデータのみ)。`query`で絞り込み可能、新しい順に表示 |
| `shanone_get_skill`    | `skill_id`を指定してSkillの完全な`instructions`を取得       |
| `shanone_create_skill` | 新しいSkillを保存(`name`、`description`、`body`はすべて必須)  |
| `shanone_update_skill` | 既存のSkillを更新 — 空でないフィールドのみが変更される                 |
| `shanone_delete_skill` | Skillを完全に削除                                     |

<Note>
  `shanone_list_skills`の`query`は、`name`と`summary`のみを対象にした、大文字小文字を区別しない単純な部分一致検索です——`instructions`の中身は検索対象外で、意味検索(embedding)も行われません。曖昧な説明文ではなく、Skillのタイトルに含まれる短く正確なキーワードを使ってください。
</Note>

MCP以外から連携する場合(スクリプトやバックエンドサービスがAPIキーを直接使う場合など)は、同じ機能をプレーンなREST API `/api/v1/skills`(一覧取得・作成は`POST`/`GET`、個別のSkillに対する操作は`/api/v1/skills/{skill_id}`への`GET`/`PUT`/`DELETE`)としても利用できます。MCPツールはこのAPIを薄くラップしたものです。

## 推奨ワークフロー

<Steps>
  <Step title="まず確認する">
    重要なタスクを始める前に、`shanone_list_skills`を(必要に応じて`query`フィルタ付きで)呼び出し、そのワークフローが既に存在しないか確認します。
  </Step>

  <Step title="読み込む">
    一致するものが見つかったら、その`skill_id`を指定して`shanone_get_skill`を呼び出し、完全な指示を取得します。
  </Step>

  <Step title="従う">
    エージェントは自身のコンテキストの中でステップを自ら実行します——指示が求める連携アクションには`shanone_search_tools` / `shanone_execute_tool`を使用します。
  </Step>

  <Step title="新しいワークフローを保存する">
    再利用する価値のあることをやり終えたら、`shanone_create_skill`を呼び出しておけば、次回以降どのエージェントからでも利用できるようになります。
  </Step>
</Steps>

## 例

```
User: "Save this as a skill called 'Weekly Status Report'."

Agent calls shanone_create_skill with:
  name: "Weekly Status Report"
  description: "Gathers last week's closed GitHub issues and posts a summary to Slack #team."
  body: |
    1. Use shanone_execute_tool with github_list_issues to fetch issues closed in the last 7 days.
    2. Summarize them into 3-5 bullet points.
    3. Use shanone_execute_tool with slack_post_message to post the summary to #team.
```

1週間後、別のマシンから:

```
User: "Run my Weekly Status Report skill."

Agent calls shanone_list_skills, finds it, calls shanone_get_skill,
then follows the instructions — calling github_list_issues and slack_post_message itself.
```

## ダッシュボードからSkillを管理する

MCP経由でできることはすべて、Shanoneのダッシュボードの**Skills**からも行えます。長い指示を手で書きたいときや、エージェントが自分の代わりに何を保存したかを確認したいときに便利です。

<Frame>
  <img src="https://mintcdn.com/duzzleinc/7a7Ov4HL3swd1T6l/images/skills/skills-list.png?fit=max&auto=format&n=7a7Ov4HL3swd1T6l&q=85&s=0ce60870e431bedc4bbd73ce0a98bdbf" alt="Shanoneダッシュボードに表示されたSkill一覧。複数の保存済みSkillの名前・説明・作成日が表示されている" width="1284" height="560" data-path="images/skills/skills-list.png" />
</Frame>

Skillを開く(または**New Skill**をクリックする)と、名前フィールド、説明フィールド、そして3つのタブを持つ本文エディタが表示されます——生のMarkdownを表示する**Code**、レンダリング結果を表示する**Preview**、変更履歴を表示する**Blame**(既存Skillの編集時のみ)です。

<Frame>
  <img src="https://mintcdn.com/duzzleinc/7a7Ov4HL3swd1T6l/images/skills/skill-editor.png?fit=max&auto=format&n=7a7Ov4HL3swd1T6l&q=85&s=b6881cfe821b3ae172ad1f0ff3e600b9" alt="Skill Name・Description欄と、MarkdownのinstructionsをCodeタブで表示したSkillエディタ" width="1284" height="900" data-path="images/skills/skill-editor.png" />
</Frame>

新規作成するSkillは、出発点として小さなMarkdownテンプレート(`## Overview` / `## Procedure` / `## Advice & Pointers` / `## Forbidden actions`)から始まります——このテンプレートから自由に外れて構いません。

## 変更履歴(Blame)

Skillの本文が更新されるたびに、Shanoneは内部的に更新前の全文スナップショットを保持します。**Blame**タブは、この履歴をgitの`git blame`と同様の行単位の表示に変換します——各行のブロックごとに、最後にそこを編集したユーザーと日時が、グレー(古い変更)からオレンジ(直近の変更)へのグラデーションで色分け表示されます。

<Frame>
  <img src="https://mintcdn.com/duzzleinc/7a7Ov4HL3swd1T6l/images/skills/skill-blame.png?fit=max&auto=format&n=7a7Ov4HL3swd1T6l&q=85&s=fa510360a6c0b0cd52732278abf8ab4e" alt="Skillのinstructionsについて、行ごとの編集者・編集日時を古い順から新しい順のグラデーションで示すBlameタブ" width="1284" height="420" data-path="images/skills/skill-blame.png" />
</Frame>

<Note>
  Blameは読み取り専用です。現時点ではこの画面から過去のバージョンを復元するボタンはありません——変更を元に戻したい場合は、該当するテキストを自分でCodeタブにコピーし直してください。
</Note>

## バージョン管理

`shanone_update_skill`を呼び出すたびに、Skillの`version`カウンターが増加し、Shanoneは更新前の全文スナップショットを記録します(これが上記のBlame表示の元データです)。ただし、ユーザー向けのロールバックAPIは提供されていません——`shanone_update_skill`は渡したフィールドの完全な置き換えとして扱い、Blameで確認できる範囲を超えて元に戻す可能性があるものは、自分自身でコピーを保管しておいてください。

<Warning>
  `shanone_delete_skill`によるSkillの削除は永久的で、元に戻すことはできません。
</Warning>

## 次のステップ

<CardGroup cols={2}>
  <Card title="ツールリファレンス" icon="book" href="/ja/mcp/tools-reference">
    すべてのSkill Vendorツールの完全なパラメータとリクエスト/レスポンスの例
  </Card>

  <Card title="権限管理とアクセス制御" icon="shield-check" href="/ja/product-guide/permissions">
    Skillは現在ユーザー単位で管理されています — チームメンバーごとのツール/サービスへのアクセス制御方法を確認してください
  </Card>
</CardGroup>