Android Skills MCP

Android Skills MCP envuelve la biblioteca android/skills de Google para que cualquier asistente de codificación de IA pueda usarla sin copiar y pegar. El repositorio incluye dos herramientas que comparten un analizador común y una instantánea empaquetada de las habilidades originales, por lo que ambas funcionan sin conexión a través de npx.

Obtienes un servidor MCP que expone la biblioteca de habilidades a cualquier cliente compatible con MCP, y una CLI de empaquetado que convierte cada SKILL.md al formato de reglas nativo de cada asistente de codificación de IA importante.

La documentación completa se encuentra en skydoves.github.io/android-skills-mcp.

Paquetes

Este es un espacio de trabajo pnpm con tres paquetes:

• android-skills-mcp es un servidor MCP. Utiliza stdio, incluye tres herramientas (list_skills, search_skills, get_skill) y expone cada habilidad como un recurso skill://. Cualquier cliente MCP (Claude Code, Cursor, Codex CLI, Windsurf) puede descubrir y extraer la habilidad correcta bajo demanda.

• android-skills-pack es una CLI. Convierte los archivos SKILL.md originales a siete formatos de reglas nativos (Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, JetBrains Junie, Continue.dev, Aider) y los escribe en tu proyecto.

• @android-skills/core es la biblioteca compartida utilizada por ambos. Analiza el frontmatter de SKILL.md con gray-matter, valida según la especificación de agentskills.io mediante zod y construye un índice BM25 con minisearch.

Cómo instalar el servidor MCP

Necesitas hacer esto una vez por máquina. Cada proyecto que abras después podrá usar las habilidades.

Claude Code

claude mcp add android-skills -- npx -y android-skills-mcp

Cursor

Añade una entrada a .cursor/mcp.json:

{
  "mcpServers": {
    "android-skills": {
      "command": "npx",
      "args": ["-y", "android-skills-mcp"]
    }
  }
}

Otros clientes MCP

Dondequiera que puedas registrar un servidor MCP con un comando stdio, ejecuta:

npx -y android-skills-mcp

La instantánea empaquetada se carga en menos de 200 ms, por lo que el coste de generar el servidor por sesión es insignificante.

Cómo instalar habilidades como archivos

Si prefieres archivos de reglas confirmados en tu repositorio en lugar de un servidor MCP, la CLI de empaquetado los escribe directamente. Puedes elegir un único objetivo o all:

npx android-skills-pack install --target cursor
npx android-skills-pack install --target claude-code
npx android-skills-pack install --target copilot
npx android-skills-pack install --target all

También puedes filtrar por una habilidad específica:

npx android-skills-pack install --target cursor --skill edge-to-edge
npx android-skills-pack install --target claude-code --skill edge-to-edge,r8-analyzer

La lista completa de objetivos compatibles:

Diseño del repositorio

android-mcp/
├── packages/
│   ├── core/   @android-skills/core   parser, schema, search index
│   ├── mcp/    android-skills-mcp     MCP server (stdio)
│   └── pack/   android-skills-pack    packager CLI
├── scripts/    sync-skills.mjs, build-skills-index.mjs
└── skills/     upstream android/skills clone (gitignored)

El directorio skills/ es un clon simple de android/skills y está ignorado por git. Solo lo necesitas para el desarrollo. Ambos paquetes publicados incluyen una instantánea analizada de las habilidades dentro de dist/skills.json, por lo que los usuarios finales nunca necesitan el repositorio original.

Desarrollo

Clona, instala y ejecuta la suite de pruebas:

git clone https://github.com/skydoves/android-skills-mcp.git
cd android-mcp
pnpm install
pnpm sync:skills
pnpm build
pnpm test

La compilación se ejecuta en orden topológico: primero core, luego mcp y pack en paralelo. Cada paquete tiene su propia suite vitest. El recuento total de pruebas es de 64 en los tres paquetes.

Puedes probar el servidor MCP a través de stdio sin ningún cliente:

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | node packages/mcp/dist/bin.js

¿Te resulta útil este repositorio? :heart:

Apóyalo uniéndote a los stargazers de este repositorio. :star: ¡También sígueme para mis próximas creaciones! 🤩

Marcas registradas

Android es una marca registrada de Google LLC. Este proyecto no está afiliado, respaldado ni patrocinado por Google LLC. El contenido de las habilidades incluido en este proyecto se redistribuye desde android/skills bajo los términos de su licencia Apache 2.0. Consulta NOTICE para obtener la atribución completa.

Claude, Cursor, GitHub Copilot, Gemini Code Assist, JetBrains Junie, Continue y Aider son marcas registradas de sus respectivos propietarios. Este proyecto los menciona para describir la compatibilidad con sus mecanismos de extensión públicos.

Licencia

Designed and developed by 2026 skydoves (Jaewoong Eum)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.