Skills de Android para agentes de IA: guía de android/skills

Skills de Android para agentes de IA: repositorio oficial Apache-2.0, instalación con Android CLI o plugin, formato SKILL.md y control del agente.
Android skills agents développement Android : guide

Skills de Android para agentes de IA: el repositorio android/skills es el repositorio oficial de instrucciones «optimizadas para IA» publicado por el equipo de Android de Google, para ayudar a un agente de código a seguir las buenas prácticas de desarrollo en Android. Tenía unas 9200 estrellas y 592 forks en octubre de 2026, según la página del repositorio el 22 de octubre, con licencia Apache-2.0. Son archivos SKILL.md en el formato abierto «Agent Skills», que agentes como Claude Code, Codex o los del ecosistema Gemini pueden cargar.

Para un equipo móvil o de plataforma, el interés es concreto: migrar a Android Gradle Plugin 9, pasar de XML a Compose, auditar la configuración de R8. Pero encargar estas operaciones a un agente exige controlar las instrucciones que se le dan y lo que modifica.

La información procede del README del repositorio y de la documentación oficial en developer.android.com, consultados el 22 de octubre de 2026. span.observer no está afiliado a Google y no ha instalado estos skills: las capturas de abajo proceden de la documentación oficial y del repositorio.

Skills de Android para agentes de IA: qué dice el repositorio

  • Quién: Android (organización android en GitHub). El archivo del plugin indica «Google / Android» como propietario.
  • Licencia: Apache-2.0 (archivo LICENSE.txt).
  • Tamaño: 86 commits, 33 tickets abiertos; no se muestra ninguna release.
  • Objetivo: según el README, el desarrollo de los skills se centra en los casos en que las evaluaciones muestran que los modelos de lenguaje tienen dificultades; los ámbitos que ya dominan bien, como las buenas prácticas básicas de Jetpack Compose, no son prioritarios.
  • Temas (carpetas de primer nivel): sistema de build (AGP 9), CameraX, coche, IA en el dispositivo, herramientas (Android CLI), identidad, Jetpack Compose, medios, navegación, rendimiento, Play, profilers, seguridad, pruebas, TV, Wear, XR.
  • Contribuciones: el README pide abrir un ticket para comentarios o peticiones de skills y precisa que por ahora no se aceptan contribuciones públicas.

Cómo se organiza un skill en un proyecto

La documentación de Android indica que el agente busca los skills en las carpetas .skills/ o .agent/skills/ en la raíz del proyecto, con una carpeta por skill que contiene un SKILL.md y posibles recursos. Solo se admiten los skills que están dentro del código del proyecto.

Captura de la documentación de Android: vista Project de Android Studio con una carpeta .skills que contiene las subcarpetas android/upgrade con un SKILL.md, commit-message-writer, skill-creator con references y scripts, test y unit-test-writer
Source : developer.android.com

El formato de SKILL.md que describe la documentación: una cabecera YAML con como mínimo name (64 caracteres como máximo, minúsculas, cifras y guiones) y description (1024 caracteres como máximo), y después el contenido. Las carpetas scripts/, references/ y assets/ son opcionales. Este es el inicio de un skill real del repositorio:

Inicio del archivo SKILL.md del skill agp-9-upgrade en el repositorio android/skills: cabecera YAML con nombre, descripción, licencia, autor Google LLC, fecha de actualización y palabras clave, y después las secciones Migration guide y Requirements

Este skill dice explícitamente cuándo no usarlo (migración de Kotlin Multiplatform) y, en su contenido, pide al agente que compruebe la versión de AGP antes de actuar. Es el tipo de barrera de seguridad (guardrail) que se espera de un buen skill.

Instalar Android skills según el README

Paso 1: con Android CLI

android skills add r8-analyzer --project=.
android skills add --all

El primer comando instala un skill en el proyecto actual; el segundo instala todos los skills para los agentes detectados. Sin la opción --all, solo se instala el skill android-cli. La opción --agent acepta una lista de agentes. Si no existe ninguna carpeta de agente, el README indica una instalación para Gemini y Antigravity en ~/.gemini/antigravity/skills. La documentación recomienda Android CLI y añade android skills list para ver los skills disponibles.

Paso 2: o como plugin de agente

/plugin marketplace add android/skills
/plugin install android-skills@android-skills

Son los comandos de Claude Code. Para Codex, el README da codex plugin marketplace add android/skills y luego codex plugin add android-skills@android-skills. Sobre el funcionamiento de los marketplaces de plugins, consulta claude-plugins-official.

Paso 3: actualizar

android skills update --all
android skills update wear-compose-m3

La documentación advierte: si modificas un skill, cámbiale el nombre; de lo contrario, skills add lo sobrescribirá en la actualización.

Extracto del README del repositorio android/skills: comandos android skills add y update, instalación como plugin para Claude Code con /plugin marketplace add android/skills, y para Codex con codex plugin marketplace add

Paso 4: usar un skill

Según el README, el agente activa por sí solo los skills pertinentes; el ejemplo que se da es la petición «Make my app UI edge-to-edge». En Android Studio, la documentación indica que también se puede invocar un skill escribiendo @nombre-del-skill en el chat.

Supervisar a un agente que modifica un proyecto Android

Un skill es un texto, no un servicio: no emite trazas ni métricas. Lo que se vigila es el agente y lo que cambia en el repositorio.

  • Revisar los diffs. Una migración de AGP o de Compose toca muchos archivos de build. Trabaja en una rama y con revisión de código, como con una contribución humana.
  • Apoyarse en la integración continua. La compilación, las pruebas unitarias y el análisis estático son la red de seguridad de un cambio hecho por un agente. Consulta las barreras de seguridad para agentes de IA en producción.
  • Medir el coste. Las migraciones largas consumen tokens: consulta el coste de un agente de IA medido con OpenTelemetry.
  • Versionar los skills. Si copias skills en .skills/, pasan a formar parte de tu repositorio: revísalos como código y conserva la versión de origen, sobre todo antes de android skills update.

Cómo comprobar que funciona

  • Tras la instalación, la carpeta del skill (por ejemplo .skills/…/SKILL.md) existe en el proyecto o en la carpeta del agente.
  • Una petición relacionada con el skill («Make my app UI edge-to-edge») debe llevar al agente a encontrar y usar el skill, según el README; comprueba en su salida si lo menciona.
  • Tras la ejecución, el proyecto compila y sus pruebas pasan antes de cualquier fusión.

Límites y puntos abiertos

  • Aviso del repositorio. «La IA puede equivocarse: verifica siempre los resultados.»
  • Contribuciones cerradas. No hay contribuciones públicas por ahora: el contenido avanza al ritmo del equipo de Android.
  • Sin release. El repositorio no muestra versión; para la reproducibilidad, anota el commit instalado.
  • Cobertura limitada a propósito. Los skills apuntan a los casos en que los modelos fallan; no sustituyen ni la documentación de Android ni la formación del equipo.
  • Agentes variados. La documentación precisa que la estructura y el uso de los skills pueden diferir ligeramente de un agente a otro: consulta la documentación de tu herramienta.

Buenas prácticas

  • Instala solo los skills que necesites en lugar de --all, y revisa cada uno.
  • Haz que el agente trabaje en una rama dedicada y exige la CI en verde.
  • Mantén un archivo de equipo que liste los skills instalados y su origen.
  • Cambia el nombre de todo skill que personalices.
  • Completa los skills públicos con tus propias reglas de arquitectura, en skills internos.

Preguntas frecuentes

¿Android skills funciona con Claude Code?

Sí, según el README: ofrece una instalación como plugin de Claude Code, además de una instalación para Codex. La documentación de Android afirma que los skills siguen el estándar abierto y son compatibles con cualquier herramienta que los admita.

¿Hace falta Android Studio?

No para Android CLI. La documentación describe también la importación de un skill en un proyecto de Android Studio, donde se puede invocar con @nombre-del-skill.

¿Qué diferencia hay con otras colecciones de skills?

Esta la publica Android y se centra en el desarrollo Android; Scientific Agent Skills cubre la investigación científica. El formato SKILL.md es el mismo.

Conclusión

El repositorio android/skills pone a disposición instrucciones oficiales para tareas Android concretas, en un formato que varios agentes entienden. Ayuda a un agente a hacerlo mejor, pero no exime de revisar. Instala pocos, fija el commit y mantén la revisión de código y la CI como barreras de seguridad.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a Google. Android es una marca de Google LLC; las demás marcas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba los comandos en la documentación oficial (developer.android.com).

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Ruflo essaims agents IA : installer et superviser

Ruflo enjambres de agentes de IA: instalar y monitorizar

Next Post
VoiceStudio clonage voix local : AGPL, install, consentement

VoiceStudio clonación de voz local: AGPL, instalación, consentimiento

Related Posts