claude-android-skill MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

Clean Architecture: UI / Domain / Data layers with strict boundaries
MVVM + Unidirectional Data Flow
Compose + Hilt + Room + Flow + Retrofit stack
Offline-first architecture baked in
Multi-module by feature — each feature self-contained with a clear API

라이브 데모

실제 사용 모습

claude-android-skill.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-android-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/dpconde/claude-android-skill",
        "~/.claude/skills/claude-android-skill"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-android-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/dpconde/claude-android-skill",
        "~/.claude/skills/claude-android-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-android-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/dpconde/claude-android-skill",
        "~/.claude/skills/claude-android-skill"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-android-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/dpconde/claude-android-skill",
        "~/.claude/skills/claude-android-skill"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-android-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/dpconde/claude-android-skill",
        "~/.claude/skills/claude-android-skill"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-android-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/dpconde/claude-android-skill",
          "~/.claude/skills/claude-android-skill"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add claude-android-skill -- git clone https://github.com/dpconde/claude-android-skill ~/.claude/skills/claude-android-skill

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: claude-android-skill

Scaffold a new Android app with modern architecture

👤 Android developers starting a greenfield project ⏱ ~60 min intermediate

언제 쓸까: You're starting a new app and don't want to make architectural mistakes you'll fix in 6 months.

사전 조건

Skill cloned — git clone https://github.com/dpconde/claude-android-skill ~/.claude/skills/claude-android-skill
Android Studio + JDK 17 — Install latest stable Android Studio

흐름

Ask Claude to scaffold the module structure

Use claude-android-skill. Scaffold a multi-module Android app called 'HabitTracker' with features: home, tracking, settings. Compose UI, Hilt DI, Room DB, offline-first.✓ 복사됨

→ Modules :app, :core:database, :core:ui, :feature:home… generated
Add first feature end-to-end

Implement the tracking feature: data layer with Room entity, domain layer with use cases, UI with Compose and ViewModel. Include unit tests.✓ 복사됨

→ Files across 3 layers + tests all compile

결과: A running app that follows NowInAndroid-style patterns.

함정

Over-engineering a tiny app into 8 modules — Tell the skill explicitly: 'single-module is fine here' for simple projects

함께 쓰기: filesystem · github

Migrate a Fragment/XML screen to Compose

👤 Android teams modernizing legacy screens ⏱ ~45 min intermediate

언제 쓸까: You have an XML screen and want Compose without rewriting everything in one go.

흐름

Analyze the existing screen

Here's the Fragment + XML for SettingsScreen. Plan a Compose migration keeping the ViewModel intact.✓ 복사됨

→ Step plan: wrap in ComposeView, port Views, clean XML
Apply the migration

Implement step 1 — add ComposeView and move the header to Compose.✓ 복사됨

→ Hybrid screen works; subsequent steps staged

결과: A Compose screen with ViewModel contract preserved.

함정

State lost during migration — Keep the same ViewModel; only the UI layer changes

함께 쓰기: github

Add offline-first support to an online-only feature

👤 Developers whose app breaks without network ⏱ ~90 min advanced

언제 쓸까: You have a Retrofit-only feature and want cached / queued behavior.

흐름

Introduce Room + repository

Use claude-android-skill to convert the profile feature to offline-first. Add Room entity, repository returning Flow, and a sync worker.✓ 복사됨

→ Data layer restructured, repository is the single source of truth
Wire UI to the Flow

Update ViewModel to collect from the repository Flow; handle loading/empty/error states in Compose.✓ 복사됨

→ UI works offline on first launch after sync

결과: A feature that works in airplane mode.

함정

Conflict resolution forgotten — Decide the strategy up front: LWW, server-wins, or merged — the skill will prompt you

조합

다른 MCP와 조합해 10배 효율

claude-android-skill + github

Open a PR per feature to keep the scaffold reviewable

Generate the home feature and open a GitHub PR with just those files.✓ 복사됨

claude-android-skill + filesystem

Edit across many modules in one session

Apply the Hilt migration across every :feature:* module.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
scaffold_module_tree	app name, feature list	Greenfield start
generate_feature	feature name, data model	Adding a new feature
migrate_to_compose	fragment/xml path	Legacy screen modernization

비용 및 제한

운영 비용

API 쿼터: None from the skill; Android SDK is free
호출당 토큰: Large — scaffold + tests can run 20k+ tokens
금액: Free
팁: Scaffold once, then iterate feature-by-feature — avoid 'generate the whole app' prompts

보안

권한, 시크릿, 파급범위

자격 증명 저장: API keys go in local.properties + BuildConfig, never committed

데이터 외부 송신: None from the skill itself

Review generated dependencies for version pins — the skill may suggest current-as-of-writing versions.

문제 해결

자주 발생하는 오류와 해결

Hilt compile error: missing @HiltAndroidApp

Ensure the Application class is annotated and declared in manifest

확인: grep -r '@HiltAndroidApp' app/src/

Room schema mismatch on migration

Either provide a Migration, or set fallbackToDestructiveMigration in dev

Compose preview won't render

Add the Compose preview dependency and annotate @Preview correctly

대안

claude-android-skill 다른 것과 비교

대안	언제 쓰나	단점/장점
Google's NowInAndroid repo	You just want a reference project to copy from	Static — doesn't generate code for you

claude-android-skill