カスタムスキル

公式スキル（Skill）は、動画、画像、音声、決済、地図、検索、サインイン、生産性といった共通の領域をカバーしています。カスタムスキルは、それらがカバーしていない部分のためのものです。自社のレビューチェックリスト、コピーのハウススタイル、社内 API、自分のチームだけが回しているワークフローなどです。作成したカスタムスキルは、アプリ構築時も一般タスクでも、公式スキルとまったく同じように呼び出せます。

#作成する 2 つの方法

サイドバーの Skill（スキル） をクリックし、Skill Center 上部の Create skill（スキルを作成） をクリックします。ホームページに移動し、プロンプトバーが Skill Creation（スキル作成） モードに切り替わります。

#言葉で説明する

「Create a skill with the following details:」に続けて文を書き、送信します。スキルの目的、MeDo がいつ使うべきか、手順として何をすべきか、絶対にしてはいけないことを書きます。ボックス下のサンプルカード（Security Review、Copy Refinement、Product Review）が、うまくいく詳しさの目安です。MeDo がスキルの下書きを作って結果を表示し、同じ会話の中で調整してから My Skills（マイスキル） に保存できます。

#パッケージをインポートする

Import Skill（スキルをインポート） をクリックし、.zip のスキルパッケージ、または単体の SKILL.md を選びます。MeDo がパッケージを読み取り、名前、説明、アイコンを入力し、必要な環境変数を検出して、スキル定義を生成します。結果を確認し、API キーの値を追加して保存します。

#外部 API をラップする

MeDo はまだ、API ドキュメントのリンクだけからスキルを自動生成することはできません。選択肢は 3 つあります。

2 つ目の方法では、開発者が必要とする情報をすべて MeDo に渡してください。良い API 説明には次の内容が含まれます。

Skill name: Weather Query
Skill description: Real-time weather by city name — temperature, humidity, conditions.

Method: GET
URL: https://api.example.com/v1/weather?city=Beijing&unit=C
Header: Authorization: Bearer YOUR_API_KEY

Parameters:
  city  — required, city name
  unit  — optional, C or F, default C

Success response:
  { "city": "Beijing", "temperature": 18, "unit": "C", "condition": "Cloudy", "humidity": 62 }

Error response:
  { "error": "invalid_city", "message": "City not found" }

Error codes: invalid_city (404), missing_city (400), invalid_unit (400),
             unauthorized (401), rate_limited (429), server_error (500)

説明に本物のキーを貼り付けないでください。プレースホルダーを使い、スキル作成後に環境変数として本物の値を入力します。

#スキルパッケージの形式

パッケージを手書きする場合も MeDo に生成させる場合も、次のレイアウトに従う必要があります。

financial-analysis.zip
└── financial-analysis/          # root folder name must equal the `name` field
    ├── SKILL.md                 # required
    ├── scripts/                 # optional: Python or shell scripts
    ├── references/              # optional: documentation, rules, knowledge
    └── assets/                  # optional: templates, icons, images

SKILL.md は frontmatter で始まり、その後にスキルの説明が続きます。

---
name: financial-analysis
description: |
  Analyze enterprise financial data and generate insights.
  Use when: (1) Financial report analysis, (2) Company comparison, (3) Risk identification
---

### Purpose

Help users analyze financial data, identify business trends, and detect potential risks.

### Instructions

1. Understand the user's input data or questions
2. Analyze key financial indicators
3. Generate structured conclusions

### Examples

Input: Financial reports from the past three years of a company

Output: Revenue trends, profit changes, and risk alerts

### Guardrails

- Do not fabricate data
- Ask follow-up questions when data is insufficient

インポート時にチェックされるルール：

いずれかに違反する .zip は理由とともに拒否されます。ファイルを修正して再度インポートしてください。

#MeDo が入力する内容

インポートに成功すると（会話で作成したスキルも同様）、スキルのページに次が表示されます。

• 基本情報 — パッケージから取得した名前、説明、アイコン。My Skills、@ の一覧、アプリの Skill ビューに表示されるのはこれらです。
• 環境変数 — スキルが必要とするキーごとに 1 項目。変数の名前は生成された固定のもので、ここに値を入力するとすべての呼び出しで使えます。空のままにすると、プロジェクトでそのスキルを初めて使うときに値を求められます。
• スキル定義 — MeDo がスキルをアプリに組み込むために使う機械可読の説明で、パッケージから生成され、手動では編集できません。一度は読んでおきましょう。API スキルなら、すべてのエンドポイント、そのパラメーター、例が含まれているはずです。何か欠けていれば、ソースファイルを修正して再インポートしてください。

#テストする

1. 任意のプロジェクトで @ を入力し、一覧の先頭から自分のスキルを選び、それを使う小さなタスクを説明します。
2. エディター左側のレールにある Skill ビューを開きます。自分のスキルが一覧にあれば、MeDo がそれを使ったということです。
3. 生成された機能を試します。API スキルなら、実際の呼び出しが実際のデータを返すことを確認してください。

スキルが一覧にない場合、MeDo はそれを関連性がないと判断しています。description とエンドポイントの説明を、あなたの依頼の言い回しに合うように磨いて、再インポートしてください。一覧にはあるのに機能が失敗する場合は、まず API キーの値を確認し、次に会話で失敗の内容を説明してください。MeDo はたいてい呼び出しを修正できます。それでも失敗が続くなら、API 説明に何か（パラメーター、レスポンス例、エラーコード）が欠けています。

#スキルを管理する

Skill → My Skills にカスタムスキルが一覧表示されます。開くと、環境変数の変更や削除ができます。

スキルを削除すると、新しいアプリやタスクでは使われなくなります。すでに使っているアプリはそのまま動き続けるので、完全に取り除きたい場合は、それぞれのアプリの Skill ビューから個別に削除してください。