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

# スキルを作成・編集する

> スキルエディタの使い方 — 手書き・自動生成・インポート

## スキルエディタを開く

* **ワークスペース共有のスキル**: サイドバー > カスタマイズ > **スキル** > 「New skill」
* **エージェント専用のスキル**: エージェント詳細の設定パネル > **スキル**セクション > 「新規作成」

既存スキルは一覧から「編集」で開きます。スキルページでは、作成・編集は一覧の右側のペインで行います（幅の狭い画面ではドロワーとして開きます）。

## エディタの構成

<Steps>
  <Step title="Frontmatter（メタ情報）を入力する">
    * **名前**（必須） — 例: PDF Extract
    * **説明** — この Skill が何をするか / どんな時に呼び出すべきか。AI がスキルを使うかどうかの判断材料になるため、具体的に書きます
    * **許可ツール**（任意） — カンマ区切りのツール名。空欄なら制限なし
  </Step>

  <Step title="本文を書く">
    「編集」タブで Markdown の本文を記述します。「プレビュー」タブで見た目を確認できます。

    <Tip>
      名前・説明を入れてから「**本文を自動生成**」を押すと、現在の入力内容から AI が本文のたたき台を生成します。
    </Tip>
  </Step>

  <Step title="保存先を選んで保存する">
    * **ワークスペース共有** — 全エージェントから紐づけ可能
    * **このエージェントだけ** — 特定エージェント専用（エージェント詳細から作成した場合）

    保存先は後から変更（昇格 / 降格）できます。**ワークスペース共有**のスキルを作成するときは最後に確認ダイアログが入ります — 他のメンバーも閲覧・利用できるようになるため、個人情報や機密が含まれていないか確認してください。
  </Step>
</Steps>

## 既存の SKILL.md をインポートする

スキルの新規作成では、フォームの最上部にインポート用のドロップゾーンがあります —「**SKILL.md をここにドラッグ**」、またはクリックしてファイルを選択します。SKILL.md のテキストをエディタへ貼り付けても取り込めます。

* Frontmatter（名前・説明・ツール）と本文が自動でフォームに反映されます
* 対応形式は Markdown（`.md`）のみ、1 ファイル最大 1 MB です

<Warning>
  ワークスペースのスキルページで**複数ファイル**を同時にドロップすると、フォームを介さず 1 ファイル 1 スキルとして即座に**ワークスペース共有**で一括作成されます（スキルごとの確認はありません）。個人情報や機密が含まれていないか、ドロップ前に確認してください。
</Warning>

## 共有スキルの編集とフォーク

<Warning>
  ワークスペース共有のスキルを編集すると、紐づいている**他のエージェントすべてに影響**します。
</Warning>

共有スキルを特定のエージェント向けに調整したい場合は、エディタの「**このエージェント専用にコピーして編集**」でフォーク（複製）してから編集してください。元のスキルには影響しません。

## 削除

エディタまたは一覧から削除できます。エージェント専用スキルの削除は復元できません。

## 書き方のコツ

* **1 スキル 1 目的** — 複数の作業を 1 つのスキルに詰め込まず、分割して管理します
* **説明文が命** — AI は説明文を見て「今このスキルを使うべきか」を判断します。「〜する時に使う」を明記しましょう
* **手順は番号付きリストで** — 曖昧な表現より、順序と条件を明確に書いた方が安定します