android-custom-skills

Verify and bootstrap the Google Android CLI (`android` command) on the user's machine. Use when the `android` command is missing, outdated, misconfigured (wrong SDK path), or when the user wants to set up `.androidrc` or wire the CLI into agents (`android init`). Triggers include "android cli 설치", "android command not found", "android update", "sdk 경로", ".androidrc", "android init", "android cli 환경설정". Do NOT use this skill for day-to-day deploy/emulator/screen workflows — those have dedicated skills.

Build and deploy an Android app to a connected device or emulator using Gradle + the Android CLI's `android describe` and `android run`. Use whenever the user wants to install / launch / sideload an app, test a code change on a device, deploy a service component, or push split APKs. Triggers include "앱 띄워줘", "디바이스에 설치", "에뮬에 deploy", "APK 설치", "run on device", "앱 빌드해서 띄워줘", "deploy". Do NOT use this skill to create or start emulators — use `android-emulator` for that.

Look up official Android best practices, guidance, and recommended patterns via the Android Knowledge Base (`android docs search` + `android docs fetch kb://…`). Use this **before** WebSearch when the question is about Android-platform topics (Compose, performance, accessibility, lifecycle, intents, build, security, edge-to-edge, foreground services, etc.). Triggers include "안드로이드 베스트 프랙티스", "Android best practice", "Compose performance", "edge-to-edge", "android docs", "공식 가이드", "권장 패턴". Do NOT use this skill for third-party libraries (Retrofit, OkHttp, Hilt) — use Context7 MCP for those.

Manage Android Virtual Devices and required system images via the Android CLI (`android emulator` + `android sdk install`). Use when the user wants to create, list, start, or stop an emulator; install a system image needed for an emulator; or recover from "no devices connected". Triggers include "에뮬레이터 만들어줘", "에뮬 켜줘", "AVD 생성", "system image 설치", "에뮬 종료", "에뮬레이터 목록", "Pixel 에뮬". Do NOT use this skill to deploy apps — `android-deploy` handles that.

Create a new Android project from an official Android CLI template using `android create`. Use when the user wants to start a new Android app from scratch, scaffold a sample project, or compare templates with `--dry-run`. Triggers include "새 안드로이드 프로젝트", "안드로이드 프로젝트 만들어줘", "compose 템플릿", "android create", "프로젝트 생성", "scaffold". Do NOT use this skill to add modules to an existing project — use Gradle / Studio for module creation.

Capture annotated screenshots of a running Android app and translate UI element labels into actual tap coordinates, using `android screen capture` + `android screen resolve` and the structured `android layout` JSON. Use when the user wants to take a screenshot, automate UI interactions without hardcoding pixel coordinates, compare UI state before/after a change, or extract the view hierarchy. Triggers include "스크린샷", "screenshot", "버튼 클릭 자동화", "UI 자동화", "tap", "view hierarchy", "layout 비교", "이 버튼 좌표". Do NOT use this skill for visual regression testing of release builds — use Playwright/Espresso for that.

Write git commit messages following the project's chosen convention (Conventional Commits, Korean variant, Gitmoji, or custom). Reads style from `.claude/android-skills.json` and onboards the project once if the config is missing. Use when the user asks to commit, draft a commit message, fix up a commit, or after staging changes. Triggers include "commit message", "커밋 메시지", "커밋 메세지", "git commit", "커밋해줘", "커밋 작성".

Generate Jetpack Compose `@Preview` functions and `PreviewParameterProvider` classes. Use whenever the user wants to add previews to a `@Composable`, set up multi-config previews (light/dark, screen sizes, font scale, locale, dynamic color), or needs a `PreviewParameterProvider` for composables that take complex parameters. Triggers include phrases like "프리뷰 추가", "preview 만들어줘", "@Preview", "PreviewParameterProvider", "다크모드 프리뷰", "multi preview".

Draft GitHub Pull Request titles and bodies that follow the project's PR convention (sections, checklist, screenshot policy, issue linking). Reads style from `.claude/android-skills.json` and onboards once if missing. Use when the user asks to open a PR, write a PR description, draft PR body, or runs `gh pr create`. Triggers include "PR 설명", "PR 본문", "pull request", "PR 만들어줘", "gh pr create".