Appllama 使用スキル は何をしますか？
Appllama はトップグロスアプリのライブラリです — 実際の画面、フロー、UIパターンに加え、収益やダウンロードのコンテキストが含まれています。MCPにより、これはエージェントの研究基盤になります：単なる調査ツールではなく、ビルダーのためのツールです。 すでに成功しているものを研究し、より良いものを構築します。
このスキルは、設計・実装のすべてのステップで appllama-design-skill と組み合わせて使用してください — このスキルは「何を研究すべきか」を教え、appllama-design-skill は「どう作るか」を教えます。
基本ルール（最初に読むこと）
get_creditsから始める — 無料です。 残高、制限、リセット日がわかります。Pro プランには月1,500クレジットが含まれます（毎月1日 UTC に全額リセット）。その他のツール呼び出しは1クレジット消費します。- 深く掘り下げる。 デザイン言語はサンプルではなく、全体のジャーニーに宿っています — タスクに重要なアプリのすべての画面を、画像も含めてウォークスルーしてください。これこそがライブラリの目的です。禁止されているのはハーベスティング（カタログ全体をスキャンしてデータセット自体を抽出すること）です。これは研究ではなく、サーバー側で検出されます。
- メディアURLは約1時間で期限切れになります。 研究したものは速やかにダウンロード/表示してください。タスク中にリンクが切れた場合は、そのページを再リクエストして新しいリンクを取得してください。スクリーンIDは永続的ですが、リンクは永続的ではありません。
- 透かしは無視する。 Appllama のすべての画像と動画には、左上隅に小さな Appllama の透かしが入っています。これは出典を示すものであり、画面の一部ではありません — その隅の読み取り（ステータスバー、戻るボタン、タイトル）を誤らせないようにし、構築するものに決して再現しないでください。
- ページネーションは順次実行されます。 すべてのリストレスポンスに
next_cursorが含まれています。それを渡して続行します。N ページ目に直接ジャンプすることはできません。また、カーソルはそれを発行した同じクエリにのみ有効です。カーソルがエラーになった場合は、それを破棄して1ページ目から再開してください。 - レート制限に達したら、待機する。 分間および日間の制限は実際の研究よりはるかに高いため、まれに制限に達した場合は、指定された時間だけ待機してください — リトライの連打はしないでください。
- エラーは指示です。 ツールエラーは行動を促すために書かれています（期限切れのカーソル → 再開、クレジット不足 → ユーザーにクレジットが1日にリセットされることと、設定→使用状況から追加リクエストできることを伝える）。
ツール一覧
| ツール | 提供内容 | 典型的な使用例 |
|---|---|---|
get_credits | 残高、制限、リセット日。無料。 | セッション開始時 |
search_apps | 10アプリ/ページ：名前、収益、ダウンロード数、評価、リリース日、スクリーン数、スクリーン数付きフローリスト。自然言語の query + フィルター（収益/ダウンロード/評価/リリース日/価格/オンボーディングステップ） + sort + board_id | カテゴリやニーズに合ったトップアプリを見つける |
get_app | 1つのアプリを完全に：評価の内訳、カテゴリ順位、アプリ内課金価格、トップ国、フロー | アプリが深く研究する価値があるか判断する |
list_app_screens | 10画面/ページ ジャーニー順（ようこそ→オンボーディング→ペイウォール→プロダクト）、各画面にメディアURL、フロー、UI要素、色が含まれます。flow または section でフィルタリング可能 | アプリを画面ごとにウォークスルーする |
search_screens | ライブラリ全体から画面を検索。mode="keyword" は画面名 + フィルター（flow、screen_type、element、app_id）をマッチング。mode="semantic" は意味やビジュアル言語で検索 | 1つの画面タイプに関するデザインリファレンスを収集する |
get_screen | 1つの画面を完全に + 他のアプリから最大5つの視覚的に類似した画面。screen_ref = app_id/screen_id（appllama.io の「画面IDをコピー」で生成される形式）を受け付けます | ユーザーが画面参照を貼り付けた場合、または1つの参照を詳しく調べる場合 |
list_flows | 画面数/アプリ数を含むフロータクソノミー | カテゴリにどのようなフローが存在するかを発見する |
get_flow_apps | フローを含むアプリ、収益上位順 | 1つのフローの最良の例を見つける |
list_ui_elements | 約38のUI要素ファミリーとその件数（1回の呼び出し） | 要素レベルの研究のための語彙 |
get_element_screens | 要素ファミリーが含まれる画面 | 勝者が1つのコンポーネントをどのように構築するかを研究する |
list_my_boards | メンバー自身のappllama.ioボード（画面/アプリ/フロー） | まず彼らのキュレーションを見つける |
get_board | ボードの全内容：メディア付き画面、アプリプロファイル、または（アプリ、フロー）のペア | メンバーがタスクのためにボードをキュレーションした場合、そこから始める |
screen_ref ハンドシェイク： メンバーは appllama.io の任意の画面で「画面IDをコピー」をクリックし、それをあなたに貼り付けることができます。それは 1393061654/spl_9i075 のような形式です。そのまま get_screen(screen_ref=...) に渡せば、メンバーが意図したその画面と、ライブラリ全体から最も近い兄弟画面をすぐに確認できます。
プレイブック
| シナリオ | 参照先 |
|---|---|
| アプリをゼロから構築する（例：「習慣トラッカーを作って」） | references/build-from-scratch.md |
| 既存の画面を改良する | references/improve-a-screen.md |
| フローと要素の研究、一般的な研究方法 | references/research-methods.md |
どちらのビルドプレイブックも同じように終わります：appllama-design-skill によるシミュレーターループを、欠点が見つからなくなるまで繰り返す。 そのループなしの研究は単なる飾りです。
ローカルリファレンスボード
研究のために画面を取得したら、ローカルの作業構造に保存してください — リンクは約1時間で期限切れになりますが、ノートとダウンロードは期限切れになりません：
research/
<カテゴリ>/
apps.md # 短縮リスト：指標、フロー、判定
<アプリ名>/
screens.md # 画面ごとのノート：ID、名前、フロー、要素、色
img/ # ダウンロードした画面、ジャーニー順
patterns.md # アプリ横断の合成：カテゴリのデザイン言語
研究しながら画面をダウンロードしてください。合成はメタデータからではなく、画像を並べて行います。ノートと画面IDは永続的です。必要に応じてIDから新しいリンクを再取得できます。