スキルの仕組み
スキルはプログレッシブローディングを使ってコンテキストを軽く保ちます。プロジェクトを開くと、Agentはすべてのスキルの名前と説明だけを見ます——それぞれ数十文字程度です。起動時に読み込まれるのはこれだけです。 あなたのリクエストがスキルの説明と一致すると、Agentはそのスキルを起動して完全な指示を読み込みます。短編小説創作スキルはクエリーレターを書いている間は休眠状態にあり、ホラー小説スキルはスリラーのアウトラインを作成中にコンテキストを消費しません。| レベル | ロードのタイミング | 内容 |
|---|---|---|
| メタデータ | 常時(起動時) | フロントマターの名前と説明 |
| 指示 | スキルが起動したとき | SKILL.md の全文 |
| サポートファイル | 必要に応じて | テンプレート、スクリプト、参照ドキュメント |
スキルの構造と保存場所
各スキルはSKILL.md ファイルを含むディレクトリです。ディレクトリ名がスキル名になります。スキルには3つのオプションサブディレクトリにサポートファイルを含めることもできます。
.soloent/skills/ に保存されます。このロマンスシリーズの特定のルールに基づいて作られたスキルや、現在の作品の尺度と語りの質感に合わせたスキルなど、特定のプロジェクトやジャンルに紐づく機能に使ってください。
スキルのオン・オフ切り替え
各スキルにはファイルを削除せずに有効・無効を切り替えるトグルがあります。現在のタスクに必要でないスキルは無効にしておくと、コンテキストから外れて意図しない起動を避けられます。スキルを作成する
SKILL.md ファイルはフロントマターブロック(メタデータ)と指示本文の2つの部分で構成されます。
nameはディレクトリ名と完全に一致する必要がありますdescriptionはAgentにいつこのスキルをトリガーするかを伝えます。何ができるかではありません(1,024文字以内)

新しいスキルを作成する
「New skill…」をクリックして名前を入力(例:
short-story)し、「+」をクリックします。Agentがテンプレートの SKILL.md ファイルを含むスキルディレクトリを作成します。english-short-story スキルの全文 — クリックして展開・コピー
english-short-story スキルの全文 — クリックして展開・コピー
3つのよくあるスキルタイプ
タイプ1:チェックリスト型
固定のタイミングで複数の基準を一度に確認するのに最適——漏れを防ぎます。例えば、章を書き終えた後の提出前チェック:タイプ2:ワークフロー型
明確なステップ順序があり、実行前に確認が必要な操作に最適。タイプ3:ドメインエキスパート型
Agentに勘ではなく専門的な経験に基づいて作業させたい場合に最適。例えば、執筆が行き詰まったときの診断スキル:完全な例:読書ノート
これはドメインエキスパート型スキルです。 コンテンツ取得パス(スクリプトが章をオンデマンドで抽出)、専門知識(docs/ に章識別パターン)、固定出力フォーマット(templates/ にノートテンプレート)——これらの3要素がドメインエキスパート型スキルの典型的な構造です。
このスキルはローカルの書籍ファイルから構造化された読書ノートを抽出します——章のまとめ、重要な洞察、名言——フォーマットされたMarkdownとして保存します。
ディレクトリ構造
なぜスクリプトが必要か
書籍は長いです。章構造を抽出するために本全体をコンテキストに読み込むのは無駄で遅い。前処理スクリプトがこの問題を解決します:infoコマンド — 最初の50行を読んでタイトル、エンコーディング、総行数を特定するchaptersコマンド — 全文を読まずに章見出しをスキャンして行番号を返すextractコマンド — 特定の章の行だけを読んで、Agentが1章ずつ処理できるようにする
なぜdocsファイルが必要か
中国語と英語の書籍では章見出しのフォーマットが大きく異なります。すべての認識パターンをSKILL.md に埋め込む代わりに、スキルは docs/chapter-patterns.md に保存します。Agentは章の境界を識別する必要があるときにこの参照ファイルを読み、それ以外は無視します。
参照資料を docs/ に置くことには2つのメリットがあります:SKILL.md をワークフローロジックに集中させられること、そしてメインの指示を変えずにパターンを更新できることです。
なぜテンプレートが必要か
出力フォーマットは固定されています:すべての読書ノートは同じ構造に従います——書籍の概要、章ごとのまとめ(重要な観点と名言を含む)、書籍全体のハイライト、個人的な考察。毎回のプロンプトでこのフォーマットを再指定する代わりに、スキルはtemplates/note-template.md に保存します。
ステップ5(最終まとめ)が実行されると、Agentはテンプレートを読み込んでプレースホルダーを埋めます。フォーマットは毎回一貫していて、1か所だけ管理すればいいです。
SKILL.mdがサポートファイルを参照する方法
SKILL.md の指示は各サポートファイルを明示的に指しています:
効果的なスキルの書き方
「いつ使うか」を書き、「何をするか」を書かない
似ているようで、トリガーの精度に大きく影響します。完全なステップ、入力、出力、停止条件を持つ
プロセスの冒頭だけ書いて明確な完了シグナルがない場合、Agentはいつ止まるかを自分で決めます——それは通常あなたが期待する場所ではありません。各ステップには以下が必要です:- 入力:このステップに必要なコンテキストやファイル
- 出力:このステップが生成するもの
- 停止条件:確認を待つタイミング、続行するタイミング
本文は骨格だけに抑え、大量データはサポートファイルへ
SKILL.md は5,000語以内に抑えてください。スタイルガイド、識別パターン、キャラクタープロフィールなど大量の参照資料が必要な場合は docs/ サブディレクトリに入れてファイル名で参照してください。Agentは必要なときだけ読み込み、そうでなければコンテキストを消費しません。
呼び出し頻度に基づいてオートトリガーを決める
| 使用頻度 | 推奨戦略 |
|---|---|
| 高頻度(セッションあたり1回以上) | オートトリガーをオンにしたまま、描述符を最適化してより正確にトリガーする |
| 低頻度(セッションあたり1回以下) | オートトリガーをオフにして手動で起動。描述符はコンテキストから外れてもよい |
| 極低頻度(月1回以下) | スキルを削除し、SOLOENT.md にドキュメントとして記録する |
よくある失敗
| 問題 | 症状 | 修正方法 |
|---|---|---|
| 説明が広すぎる | description: help with writing——どんな執筆リクエストもトリガーしてしまう | 具体的なシナリオに絞り込み、実際のトリガーフレーズを入れる |
| 本文が長すぎる | 何百行もの作業マニュアルを SKILL.md 本文に詰め込む | 参照資料を docs/ に移し、指示には骨格だけ残す |
| 1つのスキルが5つのことをしている | 同じスキルが審稿、続き、アウトライン、キャラクター設計、診断をカバー | 分割する。1ドメインに1スキル、それぞれ個別にオン・オフできる |
他者のスキルを使う
すべてのスキルをゼロから書く必要はありません。スキルは自己完結したディレクトリです——手動でインストールしたり、リポジトリからクローンしたり、プラグインとしてインストールすることができます。手動インストール
スキルディレクトリをダウンロードまたはコピーして、適切な場所に配置します:- グローバルスキル → システムレベルのスキルディレクトリ(すべてのプロジェクトで使用可能)
- ワークスペーススキル → プロジェクト内の
.soloent/skills/
git clone で入手する
GitHubで公開されているスキルはスキルディレクトリに直接クローンできます:git pull でリポジトリから変更を取り込めます。
プラグイン経由
スキルを.vsix 拡張ファイルとして配布しているスキル作成者もいます。拡張機能をインストールするとバンドルされたスキルが自動的に読み込まれます——手動でファイルを配置する必要はありません。
トラブルシューティング
スキルが期待通りに起動しない
スキルが期待通りに起動しない
最も考えられる原因:説明が十分に具体的でないか、スキルがオフになっている。
- Skills パネルでスキルがオンになっているか確認する
descriptionを書き直し、実際に使うフレーズやタスクタイプを含める——「執筆を助ける」ではほとんど正しくトリガーされない;ワークフロー、出力タイプ、サンプルの起動フレーズを具体的に記述する- スキルディレクトリに有効な
SKILL.mdがあり、nameとdescriptionの両方のフロントマターフィールドが含まれているか確認する - フロントマターの
nameがディレクトリ名と完全に一致しているか確認する
望まないときにスキルが起動し続ける
望まないときにスキルが起動し続ける
説明が広すぎます——意図していないリクエストにもマッチしてしまっている。
descriptionをこのスキルが処理する特定のタスクのみを説明するよう絞り込む- そのドメイン以外の作業をしているときはスキルをオフにする
- 説明が重複するスキルが複数ある場合は、それぞれの起動条件をより具体的にする
スキルの指示が無視される、または一部しか実行されない
スキルの指示が無視される、または一部しか実行されない
よくある原因を確認してください:
- 指示がコンテキスト制限を超えている可能性がある——
SKILL.mdを5,000語以内に抑え、参考資料はdocs/サブディレクトリに移動する - 競合するグローバルまたはプロジェクトルールがスキルの動作の一部を上書きしている可能性がある——アクティブなルールに矛盾がないか確認する
- スキルがチェックリストを使用している場合、各チェックリスト項目に明示的な「確認待ち」ゲートがあるか確認する;ない場合、Agentは自動的に進んでしまう
- 指示で参照されているサポートファイルは指定のパスに存在する必要がある——ファイルが見つからないとそのステップは黙って省略される
サポートファイル(テンプレート・ドキュメント・スクリプト)が読み込まれない
サポートファイル(テンプレート・ドキュメント・スクリプト)が読み込まれない
Agentはサポートファイルを、指示で明示的に参照されている場合のみ読み込みます。
- 指示内のファイルパスが実際の場所と一致しているか確認する(例:
chapter-outline.mdではなくtemplates/chapter-outline.md) - ファイルがスキルディレクトリ内の正しいサブディレクトリ(
templates/、docs/、またはscripts/)に存在するか確認する SKILL.mdでそのファイル名が参照されていない場合、Agentはそれを読み込む理由がない
ワークスペーススキルとグローバルスキルが同じ名前で競合している
ワークスペーススキルとグローバルスキルが同じ名前で競合している
ワークスペーススキルは常に同名のグローバルスキルより優先されます。
- これは想定された動作です——ワークスペーススキルがアクティブな場合、同名のグローバルスキルは完全に無視される
- グローバルスキルを有効にしたい場合は、ワークスペーススキルの名前を変更するか削除する
- 両方を共存させたい場合は、異なる名前をつけてそれぞれの説明を更新する
より高度なヒント
ワークフロー
ワークフローファイルで繰り返しの多段階プロセスを自動化する
ルール
執筆の好みをルールに記録して、Agentが常にあなたのスタイルで書けるようにする
ルール・ワークフロー・スキルの違い
3つのAI指示方法——それぞれの違いと使い分けを理解する