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

# Skill を作成する

> 成功したタスクからワークフローを抽出するか、QoderWork と対話しながらカスタム Skill を作成します。

既存の Skill を使うだけでなく、自分だけのカスタム Skill を作成して個人の専門知識やベストプラクティスを蓄積・再利用できます。

## 成功したタスクから抽出する

QoderWork がタスクをうまくこなしたとき、会話の中でそのワークフローを保存するよう依頼します：

> 素晴らしい結果だった——このワークフローを Skill として保存して、次回も使えるようにして

QoderWork は会話を振り返り、重要なステップ、フォーマット要件、判断基準を抽出して、構造化された Skill ファイルを生成します。確認後、保存されて次回の類似タスクに即座に利用できます。事前に計画する必要はなく、うまくいったワークフローを見つけたときにキャプチャすればOKです。

## QoderWork と共同作成する

自動化したい明確なワークフローがある場合、設定パネルから共同作成セッションを開始します：

1. 左サイドバーの **Extensions** → **Skills** ページを開き、**Create with QoderWork** をクリックします。
2. 自然言語でニーズを記述します。例：「毎週、Slack のプロジェクト議論をまとめて、進捗・リスク・来週の計画の3セクションからなるレポートにする必要がある」
3. QoderWork が説明に基づいて構造化された Skill ファイルを生成します。確認・調整後、ローカルに保存されてすぐに使えます。

技術的な詳細に触れたくない方に最適なアプローチです。必要なことを説明するだけで、QoderWork がファイルを作成します。

## Skill ファイル形式

各 Skill は基本的に、YAML フロントマター + Markdown 本文形式の `SKILL.md` ファイルです：

```markdown theme={null}
---
name: my-skill
description: この Skill の機能とトリガー条件を1行で説明
version: 1.0.0
---

# Skill 名

## ステップ
1. 最初のステップ
2. 次のステップ

## よくある落とし穴
- 避けるべき一般的なミス

## 検証
Skill が正常に実行されたことを確認する方法。
```

主要フィールドリファレンス：

| フィールド         | 必須  | 説明                                                |
| :------------ | :-- | :------------------------------------------------ |
| `name`        | はい  | Skill 名——小文字、数字、ハイフン                              |
| `description` | はい  | トリガーの説明——QoderWork はこのフィールドを使って自動呼び出しのタイミングを判断します |
| `version`     | いいえ | セマンティックバージョン番号                                    |

<Tip>
  `description` フィールドは最も重要です。QoderWork がいつ Skill を使うべきかを正確に認識できるかどうかを決定します。より具体的に、トリガーキーワードを多く含めるほど、自動トリガーの精度が高くなります。
</Tip>

## Skill をテストする

Skill を作成したら、以下の手順で検証しましょう：

1. **新しい会話を開始**し、その Skill がトリガーされるべきタスクを自然言語で説明します。
2. **自動トリガーを確認**——起動しない場合は、`description` のキーワードを調整してください。
3. **出力フォーマットを確認**——出力が期待するステップとフォーマットに従っているか確認します。
4. **エッジケースを試す**——同じ種類のタスクを異なる言い回しで説明し、安定してトリガーされることを確認します。

## 次のステップ

<CardGroup cols={3}>
  <Card title="スキルマーケット" icon="store" href="/ja/qoderwork/skill-marketplace">
    スキルの閲覧・インストール・共有
  </Card>

  <Card title="ベストスキル" icon="star" href="/ja/qoderwork/best-skills">
    公式・コミュニティ厳選のスキル
  </Card>

  <Card title="スキル" icon="wand-magic-sparkles" href="/ja/qoderwork/skills">
    スキルで QoderWork の能力を拡張する
  </Card>
</CardGroup>
