Android Skills MCP

Android Skills MCP оборачивает библиотеку Google android/skills, чтобы любой ИИ-ассистент для программирования мог использовать её без копирования и вставки. Репозиторий содержит два инструмента, которые используют общий парсер и встроенный снимок исходных навыков, поэтому оба работают офлайн через npx.

Вы получаете MCP-сервер, который предоставляет библиотеку навыков любому клиенту с поддержкой MCP, и CLI-утилиту для упаковки, которая преобразует каждый SKILL.md в собственный формат правил каждого популярного ИИ-ассистента для программирования.

Полная документация находится на сайте skydoves.github.io/android-skills-mcp.

Пакеты

Это рабочая область pnpm с тремя пакетами:

• android-skills-mcp — это MCP-сервер. Он использует stdio, содержит три инструмента (list_skills, search_skills, get_skill) и предоставляет каждый навык как ресурс skill://. Любой MCP-клиент (Claude Code, Cursor, Codex CLI, Windsurf) может обнаружить и получить нужный навык по запросу.

• android-skills-pack — это CLI-утилита. Она преобразует исходные файлы SKILL.md в семь форматов собственных правил (Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, JetBrains Junie, Continue.dev, Aider) и записывает их в ваш проект.

• @android-skills/core — это общая библиотека, используемая обоими пакетами. Она анализирует frontmatter SKILL.md с помощью gray-matter, проверяет его на соответствие спецификации agentskills.io через zod и создает индекс BM25 с помощью minisearch.

Как установить MCP-сервер

Вам нужно сделать это один раз на каждой машине. После этого каждый открываемый вами проект сможет использовать эти навыки.

Claude Code

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

Cursor

Добавьте запись в .cursor/mcp.json:

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

Другие MCP-клиенты

Везде, где вы можете зарегистрировать MCP-сервер с помощью команды stdio, выполните:

npx -y android-skills-mcp

Встроенный снимок загружается менее чем за 200 мс, поэтому затраты на запуск сервера для каждой сессии незначительны.

Как установить навыки в виде файлов

Если вы предпочитаете файлы правил, зафиксированные в вашем репозитории, а не MCP-сервер, CLI-утилита для упаковки запишет их напрямую. Вы можете выбрать одну цель или 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

Вы также можете отфильтровать конкретный навык:

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

Полный список поддерживаемых целей:

Структура репозитория

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)

Каталог skills/ является простой копией android/skills и добавлен в gitignore. Он нужен вам только для разработки. Оба опубликованных пакета содержат проанализированный снимок навыков внутри dist/skills.json, поэтому конечным пользователям никогда не потребуется исходный репозиторий.

Разработка

Клонируйте, установите и запустите набор тестов:

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

Сборка выполняется в топологическом порядке: сначала core, затем mcp и pack параллельно. Каждый пакет имеет свой собственный набор тестов vitest. Общее количество тестов — 64 для всех трех пакетов.

Вы можете протестировать MCP-сервер через stdio без какого-либо клиента:

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

Вам понравился этот репозиторий? :heart:

Поддержите его, добавив звезду этому репозиторию. :star: Также подписывайтесь на меня, чтобы не пропустить мои следующие проекты! 🤩

Товарные знаки

Android является товарным знаком Google LLC. Этот проект не связан с Google LLC, не одобрен и не спонсируется ею. Содержимое навыков, включенное в этот проект, распространяется из android/skills на условиях лицензии Apache 2.0. См. NOTICE для получения полной информации об авторстве.

Claude, Cursor, GitHub Copilot, Gemini Code Assist, JetBrains Junie, Continue и Aider являются товарными знаками соответствующих владельцев. Этот проект упоминает их для описания совместимости с их публичными механизмами расширений.

Лицензия

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.