Skip to main content

​
Skillとは何か

Skillとは、名前付きの再利用可能な指示セットのことで、コンセプトとしてはAnthropicのAgent Skillsに近いものです。各Skillは3つのフィールドを持ちます。 Shanone自身がSkillを実行することは決してありません。Skill Vendorは保存と取得だけを担うレイヤーです。エージェントはMCP経由でSkillを一覧表示・読み取りし、自身のコンテキストの中でinstructionsに従い、その過程で必要に応じてshanone_execute_tool(や他に必要なもの)を呼び出します。これによってSkillは、それを読み取るエージェントが何であっても——今日はCursor、明日はClaude Code、来週は別のノートPCでも——持ち運び可能な状態を保てます。
Skillはローカルファイルではなく、サーバー側(ShanoneのSkill Vendorバックエンド)に保存されます。一度保存すれば、あなたのアカウントが接続するあらゆる場所で利用できます。Skillはチームで共有されるものではなく、ユーザー単位で管理されます——Shanone全体へのアクセス管理については権限管理とアクセス制御を参照してください。

​
Skillが存在する理由

繰り返しをなくす

同じ複数ステップの指示を一度だけ伝えて保存し、以降は名前で参照するだけで済みます

エージェント間で持ち運び可能

Cursorで作成したSkillは、Claude Codeや、あなたのアカウントに接続する他のどのMCPクライアントからもすぐに読み取れます

段階的な開示

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

Webダッシュボードとも共有される

MCP経由で作成したSkillは、Shanoneの Web UIのSkillsにも表示されます。逆方向も同様です

​
Skill Vendorのツール

shanone_list_skillsのqueryは、nameとsummaryのみを対象にした、大文字小文字を区別しない単純な部分一致検索です——instructionsの中身は検索対象外で、意味検索(embedding)も行われません。曖昧な説明文ではなく、Skillのタイトルに含まれる短く正確なキーワードを使ってください。
MCP以外から連携する場合(スクリプトやバックエンドサービスがAPIキーを直接使う場合など)は、同じ機能をプレーンなREST API /api/v1/skills(一覧取得・作成はPOST/GET、個別のSkillに対する操作は/api/v1/skills/{skill_id}へのGET/PUT/DELETE)としても利用できます。MCPツールはこのAPIを薄くラップしたものです。

​
推奨ワークフロー

1

まず確認する

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

読み込む

一致するものが見つかったら、そのskill_idを指定してshanone_get_skillを呼び出し、完全な指示を取得します。
3

従う

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

新しいワークフローを保存する

再利用する価値のあることをやり終えたら、shanone_create_skillを呼び出しておけば、次回以降どのエージェントからでも利用できるようになります。

​
例

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

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

MCP経由でできることはすべて、ShanoneのダッシュボードのSkillsからも行えます。長い指示を手で書きたいときや、エージェントが自分の代わりに何を保存したかを確認したいときに便利です。
Shanoneダッシュボードに表示されたSkill一覧。複数の保存済みSkillの名前・説明・作成日が表示されている
Skillを開く(またはNew Skillをクリックする)と、名前フィールド、説明フィールド、そして3つのタブを持つ本文エディタが表示されます——生のMarkdownを表示するCode、レンダリング結果を表示するPreview、変更履歴を表示するBlame(既存Skillの編集時のみ)です。
Skill Name・Description欄と、MarkdownのinstructionsをCodeタブで表示したSkillエディタ
新規作成するSkillは、出発点として小さなMarkdownテンプレート(## Overview / ## Procedure / ## Advice & Pointers / ## Forbidden actions)から始まります——このテンプレートから自由に外れて構いません。

​
変更履歴(Blame)

Skillの本文が更新されるたびに、Shanoneは内部的に更新前の全文スナップショットを保持します。Blameタブは、この履歴をgitのgit blameと同様の行単位の表示に変換します——各行のブロックごとに、最後にそこを編集したユーザーと日時が、グレー(古い変更)からオレンジ(直近の変更)へのグラデーションで色分け表示されます。
Skillのinstructionsについて、行ごとの編集者・編集日時を古い順から新しい順のグラデーションで示すBlameタブ
Blameは読み取り専用です。現時点ではこの画面から過去のバージョンを復元するボタンはありません——変更を元に戻したい場合は、該当するテキストを自分でCodeタブにコピーし直してください。

​
バージョン管理

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

​
次のステップ

ツールリファレンス

すべてのSkill Vendorツールの完全なパラメータとリクエスト/レスポンスの例

権限管理とアクセス制御

Skillは現在ユーザー単位で管理されています — チームメンバーごとのツール/サービスへのアクセス制御方法を確認してください