개요
이 리포지토리는 모듈화되고 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 marketplace 플러그인이 성공적으로 설치되는데도 skills가 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' 오류를 해결하는 방법
Compose for TV가 알파에서 안정 버전(1.0.0)으로 마이그레이션되면서 TvLazyColumn의 이름이 변경되었습니다. 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' 목록으로 이동되었습니다. 이전 버전을 사용할 수밖에 없는 경우, 예제를 파싱하거나 재사용하기 전에 //` 주석과 후행 쉼표를 수동으로 제거하고 모든 문자열을 닫으세요.