> ## 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.

# Skills

Skills は、Qoder において専門知識を再利用可能な機能としてパッケージ化する仕組みです。各 Skill には `SKILL.md` ファイルが含まれ、スキルの説明、指示、およびオプションの補助ファイルが定義されています。Skills は Qoder IDE と CLI の両方で同じように動作します。

**主な特徴**：

* **インテリジェントな呼び出し**：モデルがユーザーのリクエストと説明に基づいて、いつ Skill を使用するかを自律的に判断
* **モジュラー設計**：各 Skill は特定のタスクタイプの解決に特化
* **柔軟な拡張**：ユーザーレベルとプロジェクトレベルの両方でカスタム Skill をサポート

## ユースケース

**Skill を使用するのに適したシナリオ**：

* **複雑な専門タスク**：ドメイン知識を必要とするワークフロー（コードレビュー、PDF 処理、API 設計）
* **標準化されたプロセス**：固定されたステップに従うタスク（コミット規約、デプロイフロー）
* **チーム知識の共有**：ベストプラクティスをパッケージ化してチームで共有
* **繰り返しの作業**：専門的なガイダンスを必要とする頻繁に実行されるタスク

## 組み込み Skills

IDE のチャットまたは Quest で `/` を入力すると、同梱ヘルパーを呼び出せます（例）：

| 名前                 | 用途                                        |
| :----------------- | :---------------------------------------- |
| `/create-skill`    | 新しい Skill のスキャフォールドを案内                    |
| `/create-skill-ui` | Skill 用のインタラクティブ HTML ウィジェットを生成           |
| `/vercel-deploy`   | Vercel へのワンデプロイ（OAuth とビルド）               |
| `/create-subagent` | カスタムサブエージェントのスキャフォールド                     |
| `/canvas`          | Canvas プレビューで .canvas.tsx の視覚的成果物を作成または編集 |

### Skill UI

Skill UIは、Agent実行中にインタラクティブなHTMLコンポーネント（フォーム、チャート、設定パネルなど）を直接レンダリングする機能です。生成されたコンポーネントは会話フロー内に埋め込まれ、外部ページに移動することなくチャット内で直接操作できます。初回使用時には、対象Skillのインターフェースを作成する必要があります。

Quest の Agent モードで `/create-skill-ui` コマンドを使用します。Agentが指定されたSkill用のHTML Widgetインターフェースを作成し、リアルタイムでプレビューしながらデザインを反復し、テンプレートファイルとして保存できます。

### Vercel Deploy

`/vercel-deploy`は、Questでのワンクリックデプロイ機能です。CLI設定、OAuthログイン、ビルド、本番デプロイまでの全ワークフローを自動化し、Webプロジェクトを Vercelにデプロイします。

Questの会話で`/vercel-deploy`コマンドを使用すると、Qoderが自動的にデプロイワークフローを開始します。初回デプロイ時には、QoderがVercel OAuthログインを案内します。ブラウザでプロンプトに従ってアカウント連携を完了してください。認証完了後、Qoderが自動的にプロジェクトをビルドし、Vercelの本番環境にデプロイします。デプロイ成功後、アクセス可能なライブURLが発行されます。

<Note>
  * **Vercelアカウントが必要**：デプロイ前にVercelアカウントの登録が必要です。まだお持ちでない場合は、認証フロー中に作成できます。
  * **ビルド可能なWebアプリが必要**：VercelはNext.js、React、Vue、Svelteなどの主要フレームワークをサポートしています。有効なビルド設定がない場合、デプロイに失敗する可能性があります。デプロイ前にプロジェクトがローカルで正常にビルドできることを確認してください。
</Note>

## 使い方

トリガー方法は以下の2種類があります：

1. **自動トリガー**：必要なことを直接説明すると、モデルが適切な Skill を使用するかどうかを自動的に判断します：

   ```
   このログファイルのエラーを分析して
   ```

   モデルは自動的に `log-analyzer` Skill を認識して呼び出します。

2. **手動トリガー**：`/skill-name` を入力して手動でトリガー：

   ```
   /log-analyzer
   ```

## スキルの作成（Skills）

カスタム Skills を作成または取得する方法は3つあります：

### 1. 組み込みスキルで自動作成

`create-skill` は Qoder に組み込まれたスキル作成アシスタントです。インタラクティブな対話を通じて、仕様に準拠した SKILL.md ファイルを段階的に作成できます。

**使用方法**：

```bash theme={null}
/create-skill <スキルの説明、例：Word 文書を PDF に変換>
```

<Tip>
  SKILL.md ファイルの記述規則に慣れていない場合は、まず `/create-skill` を使用して初期テンプレートを生成し、実際のニーズに応じて調整・最適化することをお勧めします。
</Tip>

**適用シナリオ**：カスタムスキルを素早く作成でき、スキルファイルの詳細な形式を理解する必要がありません。

### 2. Skills CLI でインストール

[skills CLI](https://github.com/vercel-labs/skills) を使用すると、[skills.sh](https://skills.sh) マーケットプレイスまたは GitHub からサードパーティの Skills をワンコマンドでインストールできます。

Qoder IDE のターミナルで以下のコマンドを実行します：

```bash theme={null}
# skills.sh マーケットプレイスからインストール
npx skills add vercel-labs/agent-browser -a qoder

# GitHub リポジトリから特定のスキルをインストール
npx skills add https://github.com/anthropics/skills --skill skill-creator -a qoder
```

> 詳細については、「[skills CLI ドキュメント](https://github.com/vercel-labs/skills)」をご参照ください。

**適用シナリオ**：コミュニティが共有する成熟したスキルをインストールし、すぐに使える機能を素早く取得できます。

### 3. 手動で作成

スキルを完全にカスタマイズしたい場合は、SKILL.md ファイルを手動で作成し、指定されたディレクトリに配置できます。

**手順**：

1. スキルディレクトリと SKILL.md ファイルを作成
2. 以下のいずれかのパスにファイルを配置：

| 場所        | パス                                      | スコープ               |
| --------- | --------------------------------------- | ------------------ |
| ユーザーレベル   | `~/.qoder/skills/{skill-name}/SKILL.md` | 現在のユーザーのすべてのプロジェクト |
| プロジェクトレベル | `.qoder/skills/{skill-name}/SKILL.md`   | 現在のプロジェクトのみ        |

3. Qoder IDE を再起動し、ダイアログで `/` を入力すると読み込まれた Skills リストを確認できます

> **ヒント**：ユーザーレベルとプロジェクトレベルに同名の Skill が存在する場合、プロジェクトレベルの Skill が優先されます。

**適用シナリオ**：スキルの内容を完全にカスタマイズする必要がある場合、または既存のスキルファイルを直接インポートする場合。

## シナリオ例

### ログ分析

「このログを分析して」と言うと自動的にアクティブになり、エラー、パフォーマンスの問題、異常パターンの特定を支援する `log-analyzer` Skill を作成します。

### API ドキュメント生成

API エンドポイントを自動的に識別し、標準ドキュメントと OpenAPI 仕様を生成する `api-doc-generator` Skill を作成します。

### コードレビュー

チーム標準に従って自動的にコードをレビューし、潜在的な問題とベストプラクティスをチェックする `code-reviewer` Skill を作成します。

## 詳細ドキュメント

Skills の完全ガイド（作成方法、SKILL.md の書き方、ベストプラクティス、トラブルシューティングを含む）については、[Skills 完全ドキュメント](/ja/cli/Skills)を参照してください。
