Communitygithub.com

lerchenflo/claudeskills

Bietet Anweisungen zur Installation und Nutzung des `android` CLI. Das `android`-Befehlszeilenwerkzeug ist ein zentrales Werkzeug für die Android-Entwicklung und hilft beim Erstellen neuer Android-Projekte, Ausführen von Android-Apps auf Geräten, Verwalten und Interagieren mit virtuellen Android-Geräten (einschließlich Screenshots und UI-Inspektion), Verwalten von Android SDK-Komponenten, Nachschlagen offizieller Android-Dokumentation und Entdecken sowie Installieren offizieller Android-Fähigkeiten.

Was ist claudeskills?

Diese Fähigkeit (Skill) verwandelt einen KI-Agenten in einen Android-Entwicklungsspezialisten und bietet direkten Zugriff auf die `android` CLI. Sie deckt den gesamten Entwicklungslebenszyklus ab: Projekterstellung aus Vorlagen, SDK-Verwaltung (Installation, Aktualisierung, Entfernung von Paketen), Interaktion mit Geräten und Emulatoren (Starten, Stoppen, Screenshots, UI-Layout-Inspektion) sowie das Ausführen und Installieren von Apps. Für die Arbeit mit Geräten und UI-journey-Tests sind Referenzdateien (`interact.md`, `journeys.md`) enthalten, die detaillierte Anweisungen zur korrekten Nutzung des `android layout` und `android screen` Befehls geben. Der Skill unterstützt Linux, macOS (Arm/Intel) und Windows und kann über die Plattformen Claude Code, Cursor und Codex verwendet werden. Durch die Integration der offiziellen Android-Dokumentationssuche (`android docs`) und die Verwaltung weiterer Skills (`android skills`) wird sichergestellt, dass der Agent stets mit aktuellen und relevanten Informationen arbeitet. Die ausführliche Hilfeseite (`android help`) listet alle verfügbaren Befehle und Optionen auf.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lerchenflo/claudeskills/tree/HEAD/android/android-cli

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Android CLI Spezialist

Dieser Skill bietet Anweisungen zur Verwendung des android CLI-Werkzeugs. Das Tool enthält verschiedene Befehle zum Erstellen von Projekten, Ausführen von Anwendungen, Interagieren mit Geräten und Verwalten der CLI-Umgebung.

Installation

Wenn das android-Werkzeug nicht im Pfad ist, installieren Sie es. Führen Sie dazu den folgenden Befehl aus: Linux: curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh | bash Mac Arm: curl -fsSL https://dl.google.com/android/cli/latest/darwin_arm64/install.sh | bash Mac Intel: curl -fsSL https://dl.google.com/android/cli/latest/darwin_x86_64/install.sh | bash Windows: curl -fsSL https://dl.google.com/android/cli/latest/windows_x86_64/install.cmd -o "%TEMP%\i.cmd" && "%TEMP%\i.cmd"

SDK-Verwaltung

Zur Verwaltung der Installation von Android SDKs und Werkzeugen verwenden Sie den Befehl sdk. Zum Beispiel:

  • android sdk install <paket>[@<version>]...: Installiert bestimmte Pakete. Mehrere Pakete können durch Leerzeichen getrennt angegeben werden. <version> standardmäßig auf die neueste Version. Beispiel: android sdk install platforms/android-30@2 platforms/android-34
  • android sdk update [<pkg-name>]: Aktualisiert ein bestimmtes Paket oder alle Pakete auf die neueste Version.
  • android sdk remove <pkg-name>: Entfernt ein Paket aus dem lokalen SDK.
  • android sdk list --all: Listet installierte und verfügbare SDK-Pakete auf.

Projekterstellung

Erstellen Sie Projekte aus Vorlagen mit dem Befehl create.

Zum Beispiel: android create empty-activity --name="Meine App" --output=./my-app

Interaktion mit Android-Geräten

Verwenden Sie den Befehl android layout, um das UI-Layout einer Android-Anwendung im JSON-Format zu inspizieren. Verwenden Sie den Befehl android screen, um die UI visuell zu inspizieren und Begrenzungskoordinaten für visuelle Bereiche zu erhalten.

WICHTIG: Bevor Sie android layout oder android screen verwenden, MÜSSEN Sie diese Referenz lesen: interact.md Die Referenzdatei interact.md enthält Anweisungen zur ordnungsgemäßen Interaktion mit Android-Geräten. Befolgen Sie deren Anweisungen genau.

Ausführen von Journey-Tests

Journey-Tests beinhalten Geräteinteraktion; verwenden Sie die Befehle android layout und android screen, um Journeys zu bewerten. Auch hier gelten die Anweisungen zur Geräteinteraktion.

WICHTIG: Bevor Sie eine Journey bewerten, MÜSSEN Sie diese Referenz lesen: journeys.md Die Referenzdatei journeys.md enthält Anweisungen zur korrekten Bewertung einer Android-Journey. Befolgen Sie deren Anweisungen genau.

Dokumentsuche

Der Befehl docs durchsucht maßgebliche, hochwertige Android-Entwicklerdokumentation in der Android-Wissensdatenbank. Durch die Angabe weniger Schlüsselwörter gibt dieses Werkzeug hochwertige Artikel zurück, die Beispiele oder Anleitungen zur Verwendung von Android-APIs oder -Bibliotheken enthalten. Verwenden Sie dieses Werkzeug, um zusätzliche Informationen zur Durchführung Android-spezifischer Aufgaben zu erhalten oder mehr über Android-APIs, Oberflächen, Bibliotheken oder Geräte zu erfahren.

Verwenden Sie dieses Werkzeug immer, um die aktuellsten Informationen zu Android-Konzepten zu erhalten. Typische gute Anwendungsfälle sind:

  • Finden von Migrationsleitfäden für APIs.
  • Finden von Beispielen für APIs.
  • Finden aktueller Informationen zu Android-APIs.
  • Finden von Best Practices für Android-Konzepte.

Ausführen von APKs

Verwenden Sie den Befehl run, um Android-Apps auszuführen.

Verwalten von Emulatoren

Verwalten Sie Android Virtual Devices (AVDs) mit dem Befehl android emulator.

Erstellen von Screenshots

Erfassen Sie ein Bild des aktuellen Bildschirms eines verbundenen Android-Geräts und geben Sie es mit dem Befehl android screen in eine Datei aus.

Verwalten von Skills

Verwalten Sie Agenten-Skills für Android mit dem Befehl android skills.

Aktualisieren der CLI

Aktualisieren Sie die Android-CLI mit dem Befehl android update.

Ausgabe von android help

Usage: android [-Vhv] [--sdk=PARAM] [COMMAND]
  -h, --help       Hilfe zu diesem Befehl anzeigen
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung aktivieren
  -V, --version    Versionsinformationen anzeigen und beenden
Commands:
  completion  Installiert die Shell-Autovervollständigungskonfiguration für die Android-CLI im aktuellen Benutzerprofil
  create      Erstellt ein neues Android-Projekt aus verfügbaren Vorlagen. Ermöglicht die Angabe von Projektname, Ausgabeverzeichnis, minSdk und Trockenlauf-Ausführung
  describe    Analysiert ein Android-Projekt, um beschreibende Metadaten zu generieren. Dieser Befehl identifiziert und gibt die Pfade zu JSON-Dateien aus, die die Projektstruktur detailliert beschreiben, einschließlich Build-Zielen und deren entsprechenden Ausgabeartefakt-Speicherorten (z.B. APKs). Diese Informationen ermöglichen es anderen Werkzeugen und Befehlen, Build-Artefakte effizient zu finden
  docs        Android-Dokumentationsbefehle zum Suchen und Abrufen von Entwicklerdokumentation aus der offiziellen Wissensdatenbank
  emulator    Verwaltet Android Virtual Devices (AVDs). Enthält Befehle zum Starten, Stoppen, Auflisten und Anzeigen von Details zu Emulatoren
  help        Zeigt die Hilfe aller Befehle an
  info        Gibt Umgebungsinformationen aus, einschließlich SDK-Speicherort, verbundener Geräte und Konfigurationsvariablen. Verwenden Sie bestimmte Felder, um die Ausgabe einzugrenzen
  init        Initialisiert die Umgebung für die Android-CLI. Richtet erforderliche Konfigurationen, Verzeichnisse und Standard-Skills ein
  install     Installiert eine Android-Anwendung (ein oder mehrere APKs) auf einem verbundenen Gerät oder Emulator, ohne Komponenten zu aktivieren, mit inkrementellen Optimierungen für eine schnellere Bereitstellung als adb
  layout      Gibt den Layout-Baum einer Anwendung zurück
  run         Erstellt, bereitstellt und startet eine Android-Anwendung auf einem verbundenen Gerät oder Emulator
  screen      Befehle zum Anzeigen des Geräts
  sdk         Verwaltet die Android SDK-Installation. Enthält Befehle zum Installieren, Aktualisieren, Entfernen und Auflisten verfügbarer und installierter SDK-Pakete
  skills      Verwaltet Android-CLI-Skills. Enthält Befehle zum Installieren, Entfernen, Auflisten und Suchen nach Skills nach Schlüsselwort
  studio      Android Studio-Befehle
  update      Aktualisiert die Android-CLI auf die neueste Version

completion

Usage: android completion [-h] [<shell>]
Installiert die Shell-Autovervollständigungskonfiguration für die Android-CLI im aktuellen Benutzerprofil

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung aktivieren
  -V, --version    Versionsinformationen anzeigen und beenden

Positional Parameters:
  <shell>  Wenn angegeben, die Vervollständigung für die angegebene Shell ausgeben, ohne zu installieren. Unterstützt: bash, zsh

create

Usage: android create [-h] [--application-id=PARAM] [--list] [--min-sdk=PARAM]
                      [--name=PARAM] [--namespace=PARAM] [--output=PARAM]
                      [<template-name>]
Erstellt ein neues Android-Projekt aus verfügbaren Vorlagen. Ermöglicht die Angabe von Projektname, Ausgabeverzeichnis, minSdk und Trockenlauf-Ausführung

Options:
      --application-id=PARAM  Die Anwendungs-ID für die Anwendung
                              (z.B. 'com.beispiel.meineapp')
  -h, --help                  Hilfe zu diesem Befehl anzeigen
      --list                  Alle verfügbaren Vorlagen auflisten
      --min-sdk=PARAM         Der von der Anwendung unterstützte 'minSdk'
                              (Standard ist in der Vorlage definiert)
      --name=PARAM            Der Name der Anwendung (z.B. 'Meine
                              Anwendung')
      --namespace=PARAM       Der Namespace für Ressourcen und Paketname
                              für Kotlin-Quelldateien
  -o, --output=PARAM          Das Zielprojektverzeichnis (Standard
                              ist '.')

android options:
      --sdk=PARAM             Pfad zum Android SDK
  -v, --verbose               Ausführliche Ausgabe für Fehlerbehebung
  -V, --version               Versionsinformationen anzeigen und beenden

Positional Parameters:
  <template-name>  Der Vorlagenname

describe

Usage: android describe [-h] [--project_dir=PARAM]
Analysiert ein Android-Projekt, um beschreibende Metadaten zu generieren. Dieser Befehl identifiziert und gibt die Pfade zu JSON-Dateien aus, die die Projektstruktur detailliert beschreiben, einschließlich Build-Zielen und deren entsprechenden Ausgabeartefakt-Speicherorten (z.B. APKs). Diese Informationen ermöglichen es anderen Werkzeugen und Befehlen, Build-Artefakte effizient zu finden

Options:
  -h, --help               Hilfe zu diesem Befehl anzeigen
      --project_dir=PARAM  Das zu beschreibende Projektverzeichnis

android options:
      --sdk=PARAM          Pfad zum Android SDK
  -v, --verbose            Ausführliche Ausgabe für Fehlerbehebung
  -V, --version            Versionsinformationen anzeigen und beenden

docs

Usage: android docs [-h] [COMMAND]
Android-Dokumentationsbefehle zum Suchen und Abrufen von Entwicklerdokumentation aus der offiziellen Wissensdatenbank

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung
  -V, --version    Versionsinformationen anzeigen und beenden
Commands:
  fetch   Ruft einen Android-Dokumentationsartikel von einer URL ab (kb://...)
  search  Durchsucht die Android-Dokumentation. Schlüsselwörter in Anführungszeichen setzen

emulator

Usage: android emulator [-h] [COMMAND]
Verwaltet Android Virtual Devices (AVDs). Enthält Befehle zum Starten, Stoppen, Auflisten und Anzeigen von Details zu Emulatoren

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung
  -V, --version    Versionsinformationen anzeigen und beenden
Commands:
  create  Erstellt ein virtuelles Gerät
  list    Listet verfügbare virtuelle Geräte auf
  remove  Löscht ein virtuelles Gerät
  start   Startet das angegebene virtuelle Gerät. Dieser Befehl kehrt zurück, wenn der Emulator vollständig gestartet und einsatzbereit ist
  stop    Stoppt das angegebene virtuelle Gerät

help

Usage: android help [-h] [COMMAND]
Zeigt die Hilfe aller Befehle an

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung
  -V, --version    Versionsinformationen anzeigen und beenden

Positional Parameters:
  COMMAND  Der Befehl, für den Hilfe angezeigt werden soll

info

Usage: android info [-h] [<field>]
Gibt Umgebungsinformationen aus, einschließlich SDK-Speicherort, verbundener Geräte und Konfigurationsvariablen. Verwenden Sie bestimmte Felder, um die Ausgabe einzugrenzen

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung
  -V, --version    Versionsinformationen anzeigen und beenden

Positional Parameters:
  <field>  Das spezifische Feld, dessen Wert ausgegeben werden soll. Wenn nicht angegeben, wird alles ausgegeben

init

Usage: android init [-h]
Initialisiert die Umgebung für die Android-CLI. Richtet erforderliche Konfigurationen, Verzeichnisse und Standard-Skills ein

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung
  -V, --version    Versionsinformationen anzeigen und beenden

install

Usage: android install [-h] [--apks=PARAM] [--device=PARAM] [--install-options=PARAM]
                       [--use-delta-install]
Installiert eine Android-Anwendung (ein oder mehrere APKs) auf einem verbundenen Gerät oder Emulator, ohne Komponenten zu aktivieren, mit inkrementellen Optimierungen für eine schnellere Bereitstellung als adb

Options:
      --apks=PARAM             Die Pfade zu den APKs, durch Komma getrennt
      --device=PARAM           Die Seriennummer des Geräts
  -h, --help                   Hilfe zu diesem Befehl anzeigen
      --install-options=PARAM  Zusätzliche Optionen/Flags, die an die Paketverwaltungsinstallation übergeben werden sollen (z.B. -g,-d)
      --use-delta-install      Schnelle Delta-Installation verwenden (beschleunigt inkrementelle Aktualisierungen durch Übertragung nur geänderter Code- und Ressourcen; Standard: true)

android options:
      --sdk=PARAM              Pfad zum Android SDK
  -v, --verbose                Ausführliche Ausgabe für Fehlerbehebung
  -V, --version                Versionsinformationen anzeigen und beenden

Positional Parameters:
  [APK_PATH]...  Die APK-Dateien, die installiert werden sollen

layout

Usage: android layout [-h]
Gibt den Layout-Baum einer Anwendung zurück

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung
  -V, --version    Versionsinformationen anzeigen und beenden

run

Usage: android run [-h] [--app-id=PARAM] [--args=PARAM] [--device=PARAM]
Erstellt, stellt bereit und startet eine Android-Anwendung auf einem verbundenen Gerät oder Emulator

Options:
      --app-id=PARAM   Die Anwendungs-ID (z.B. 'com.beispiel.meineapp')
      --args=PARAM     Zusätzliche Argumente, die an die Anwendung übergeben werden sollen
      --device=PARAM   Die Seriennummer des Geräts
  -h, --help           Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM      Pfad zum Android SDK
  -v, --verbose        Ausführliche Ausgabe für Fehlerbehebung
  -V, --version        Versionsinformationen anzeigen und beenden

Positional Parameters:
  [APK_PATH]  Pfad zur APK-Datei

screen

Usage: android screen [-h] [COMMAND]
Befehle zum Anzeigen des Geräts

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung
  -V, --version    Versionsinformationen anzeigen und beenden
Commands:
  capture  Erfasst einen Screenshot des aktuellen Gerätebildschirms
  view     Zeigt eine visuelle Darstellung des Gerätebildschirms.
           Nützlich, wenn der Benutzer nach dem sucht, was auf dem Gerät ist

sdk

Usage: android sdk [-h] [COMMAND]
Verwaltet die Android SDK-Installation. Enthält Befehle zum Installieren, Aktualisieren, Entfernen und Auflisten verfügbarer und installierter SDK-Pakete

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung
  -V, --version    Versionsinformationen anzeigen und beenden
Commands:
  install  Installiert SDK-Pakete.
  list     Listet installierte und verfügbare SDK-Pakete auf
  remove   Entfernt ein Paket aus dem lokalen SDK
  update   Aktualisiert ein bestimmtes Paket oder alle Pakete auf die neueste Version

skills

Usage: android skills [-h] [COMMAND]
Verwaltet Android-CLI-Skills. Enthält Befehle zum Installieren, Entfernen, Auflisten und Suchen nach Skills nach Schlüsselwort

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung
  -V, --version    Versionsinformationen anzeigen und beenden
Commands:
  install  Installiert einen Skill.
  list     Listet installierte Skills auf
  remove   Entfernt einen installierten Skill
  search   Sucht in Skills nach Schlüsselwort

studio

Usage: android studio [-h] [COMMAND]
Android Studio-Befehle

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung
  -V, --version    Versionsinformationen anzeigen und beenden
Commands:
  launch   Startet Android Studio
  open     Öffnet ein Android-Projekt in Android Studio

update

Usage: android update [-h]
Aktualisiert die Android-CLI auf die neueste Version

Options:
  -h, --help       Hilfe zu diesem Befehl anzeigen

android options:
      --sdk=PARAM  Pfad zum Android SDK
  -v, --verbose    Ausführliche Ausgabe für Fehlerbehebung
  -V, --version    Versionsinformationen anzeigen und beenden

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Verwandte Skills