メインコンテンツへスキップ

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 は Agent にドメインの専門知識を付加します。1 つの Skill は構造化された指示とフローのまとまりで、特定タスクにおける Agent の挙動をより専門的かつ信頼性の高いものにします。

​
Skill の役割

  • 専門知識の注入 — 汎用 Agent に特定領域の能力 (コードレビュー、ドキュメント生成など) を持たせる
  • フローの標準化 — Agent が統一された手順で実行することを保証し、出力を一貫させる
  • 再利用可能 — 一度作成すれば、複数の Agent で共有

​
Skill ファイル構造

Skill は .zip ファイルとしてアップロードし、以下を含みます。 
my-skill/
├── SKILL.md          # 必須: Skill 定義ファイル
├── templates/        # 任意: テンプレートファイル
│   └── report.md
└── examples/         # 任意: サンプルファイル
    └── sample.json
SKILL.md がコアファイルで、YAML frontmatter + Markdown 形式を使用します。 
name: code-review
description: 構造化されたコードレビューを実施し、改善提案を出力する
version: 1.0.0

# Code Review

## Steps
1. コード構造とアーキテクチャを分析する
2. 一般的な問題 (セキュリティ、パフォーマンス、保守性) を確認する
3. 構造化されたレビューレポートを出力する

## Pitfalls
- フォーマットの問題のみに着目せず、ロジックエラーを優先する
- 漠然とした批判ではなく、具体的な修正提案を提示する

​
Skill を作成する

POST https://openapi.qoder.sh/api/v1/cloud/skills
Content-Type: multipart/form-data

​
curl の例

# まず Skill ディレクトリを zip 化
cd my-skill && zip -r ../my-skill.zip . && cd ..

# アップロード
curl -X POST https://openapi.qoder.sh/api/v1/cloud/skills \
  -H "Authorization: Bearer $QODER_PAT" \
  -F "file=@my-skill.zip"
レスポンス: 
{
  "id": "skl_abc123",
  "name": "code-review",
  "description": "構造化されたコードレビューを実施し、改善提案を出力する",
  "version": "1.0.0",
  "created_at": "2026-05-01T10:00:00Z"
}

​
Agent への関連付け

Agent の skills フィールドで Skill をバインドします。 
curl -X PATCH https://openapi.qoder.sh/api/v1/cloud/agents/agt_abc123 \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "skills": ["skl_abc123", "skl_def456"]
  }'
Skills の関連付け機能は現在 M2 ゲート段階にあり、申請による開通が必要です。

​
バージョン管理

同じ名前の Skill を再アップロードすると、新しいバージョンが作成されます。 
# SKILL.md の version フィールドを更新してから再アップロード
curl -X POST https://openapi.qoder.sh/api/v1/cloud/skills \
  -H "Authorization: Bearer $QODER_PAT" \
  -F "file=@my-skill-v2.zip"
Agent に関連付けた Skill は常に最新バージョンを使用します。

​
Skill の詳細を取得

curl https://openapi.qoder.sh/api/v1/cloud/skills/skl_abc123 \
  -H "Authorization: Bearer $QODER_PAT"

​
すべての Skills を一覧表示

curl https://openapi.qoder.sh/api/v1/cloud/skills \
  -H "Authorization: Bearer $QODER_PAT"
レスポンス: 
{
  "data": [
    {
      "id": "skl_abc123",
      "name": "code-review",
      "version": "1.0.0",
      "created_at": "2026-05-01T10:00:00Z"
    },
    {
      "id": "skl_def456",
      "name": "doc-generator",
      "version": "2.1.0",
      "created_at": "2026-04-20T08:30:00Z"
    }
  ]
}

​
Skill を削除する

curl -X DELETE https://openapi.qoder.sh/api/v1/cloud/skills/skl_abc123 \
  -H "Authorization: Bearer $QODER_PAT"
Skill を削除すると、その Skill を関連付けていた Agent は次回の Session 作成時に Skill をロードしません。

​
Skill 作成の指針

  1. トリガー条件を明示 — description に、いつ使用すべきかを明確に記述
  2. 手順を具体的に — Steps には曖昧な記述ではなく、正確な操作を記載
  3. 落とし穴を記録 — Pitfalls で Agent が陥りがちなミスを回避
  4. 検証手順を提供 — タスク完了をどう確認するかを Agent に伝える

​
よくある質問

Q: Skill と instructions の違いは? A: instructions は Agent の汎用指示で、すべてのタスクに有効です。Skill は必要に応じて起動される専門モジュールで、Agent がタスク内容に応じて使うかどうかを判断します。 Q: 1 つの Agent に何個の Skills を関連付けられますか? A: ハードリミットはありませんが、Agent の挙動を予測可能に保つため 10 個以内を推奨します。 Q: Skills 機能はいつフルオープンしますか? A: 現在 M2 ゲート段階で、後続バージョンでフルオープン予定です。早期開通の申請はサポートまでご連絡ください。 Q: zip ファイルにサイズ制限はありますか? A: 単一 Skill の zip ファイルは 10MB 以下です。