概要
このリポジトリは、モジュール化されたAI向けに最適化された指示ファイル（SKILL.md）を提供し、LLMエージェントがAndroid公式開発のベストプラクティスを習得できるよう支援します。特に、評価において大規模モデルのパフォーマンスが低いシナリオを重点的にカバーしています。Android CLI経由でインストールできるほか、Claude Code、Codexなどのエージェントのプラグインとしても使用できます。
README プレビュー
## Android skills\n\n**Android skills** are a dedicated repository of **AI-optimized, modular instructions** and\nresources, to help agents better understand and execute specific patterns that follow the best\npractices and guidance on Android development\nfrom [developer.android.com](https://developer.android.com).\n\nAndroid skills follow the [open-standard agent skills](https://agentskills.io/home) - markdown\nfiles (SKILL.md) that provide a technical specification of a task, and **ground LLMs** with\ninformation on specialized domains and workflows.\n\nOur Android skill development focuses on **use cases and workflows where evaluations show LLMs\nunderperform**.\nWe aren't prioritizing well-established areas where LLMs are already proficient, such\nas basic Jetpack Compose best practices.\n\nTo learn more, read the official documentation:\n\n- [Android skills](https://developer.android.com/tools/agents/android-skills)\n- [Android CLI](https://developer.android.com/tools/agents/android-cli)\n- [Android Studio](https://developer.android.com/studio/gemini/skills)\n\n### Install Android skills\n\nUse Android CLI to install a specific skill into the current directory:\n\n```\nandroid skills add r8-analyzer --project=.\n```\n\nUse Android CLI to install all Android skills to directories for all detected agents:\n\n```\nandroid skills add --all\n```\n\nIf you don't have any existing agent directories and don't specify particular agents, the skills\nwill be installed for Gemini and Antigravity at `~/.gemini/antigravity/skills`.\n\n**Options:**\n\n- `--all` - Add all Android skills. If omitted, only the `android-cli` skill will be installed.\n- `--agent` - A comma-separated list of agents to install the skill for. If omitted, the skill will be installed for all detected agents.\n- `--project` - Path to a project root in which to install the skills.\n\n\nTo update all skills or specific ones, run:\n\n```\nandroid skills update --all\nandroid skills update wear-compose-m3\
FAQ (3)
トラブル対応Codexマーケットプレイスのプラグインは正常にインストールされるのに、スキルが0件と表示されるのはなぜですか？
これはプラグインバージョン 1.0.15 の既知のバグです: .codex-plugin/plugin.json は skills をオブジェクトの配列（{ "source": { "path": "..." } }）として宣言していましたが、Codex CLI 0.163.0 はパス文字列または文字列の配列しか受け付けないため、30 件すべてのスキルエントリが警告なく無視されていました。修正（PR #247）では、すべてのエントリを単純なパス文字列に変換します（例: "skills": ["./devtools/android-cli"]）。プラグインを修正済みリリースに更新し、Codex セッションを再起動してください。影響を受けるバージョンでの回避策として、マーケットプレイスを経由せずにスキルを直接インストールできます: android skills add --agent codex — これにより 30 個すべての Android スキルが検出可能になります。モデルへのリクエストを行わずに検出を確認するには、codex debug prompt-input "Reply with exactly OK." を実行し、生成されたスキルカタログを確認してください。
トラブル対応Compose for TVで「Unresolved reference: TvLazyColumn」エラーを修正する方法
TvLazyColumn は、Compose for TV がアルファ版から安定版（1.0.0）へ移行した際に名前が変更されました。TvLazyColumn を標準の LazyColumn に置き換え、TV 固有のパッケージではなく androidx.compose.foundation.lazy.LazyColumn からインポートしてください。TvLazyRow → LazyRow についても同様です。公式の移行ガイドを参照してください：https://medium.com/androiddevelopers/migrating-compose-for-tv-from-alpha-to-stable-b0074d6fd350
トラブル対応android-cli の journeys.md の 'Summarizing' セクションにある JSON の例がパースに失敗するのはなぜですか？
devtools/android-cli スキルの古いバージョンでは、references/journeys.md に不正な形式のサンプルが同梱されていました。インラインの // コメント、末尾のカンマ、閉じられていない文字列（"action": "Click the blue button,）、および不正な形式の "journey:", キーが含まれていたため、JSON としてパースできませんでした。修正方法: android-cli スキルを最新バージョンに更新してください。最新バージョンでは、サンプルは ``json でフェンスされ、有効な構文（閉じられた文字列、末尾のカンマなし、コメントなし）になり、フィールドの説明（status、commands、comment、有効な status の値）はサンプルの下にある独立した「Field reference」リストに移動されました。古いコピーから移行できない場合は、サンプルをパースまたは再利用する前に、//` コメントと末尾のカンマを手動で取り除き、すべての文字列を閉じてください。