You get an MCP server that exposes the skill library to any MCP capable client, and a packager CLI that converts each SKILL.md into the native rules format of every major AI coding assistant.
Full documentation lives at skydoves.github.io/android-skills-mcp.
Packages
This is a pnpm workspace with three packages:
android-skills-mcpis an MCP server. It speaks stdio, ships three tools (list_skills,search_skills,get_skill), and exposes every skill as askill://resource. Any MCP client (Claude Code, Cursor, Codex CLI, Windsurf) can discover and pull the right skill on demand.android-skills-packis a CLI. It converts the upstreamSKILL.mdfiles into seven native rules formats (Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, JetBrains Junie, Continue.dev, Aider) and writes them into your project.@android-skills/coreis the shared library used by both. It parsesSKILL.mdfrontmatter withgray-matter, validates against the agentskills.io spec viazod, and builds a BM25 index withminisearch.
How to install the MCP server
You need this once per machine. Every project you open afterwards can use the skills.
Claude Code
claude mcp add android-skills -- npx -y android-skills-mcp
Cursor
Add an entry to .cursor/mcp.json:
{
"mcpServers": {
"android-skills": {
"command": "npx",
"args": ["-y", "android-skills-mcp"]
}
}
}
Other MCP clients
Anywhere you can register an MCP server with a stdio command, run:
npx -y android-skills-mcp
The bundled snapshot loads in under 200 ms, so the cost of spawning the server per session is negligible.
How to install skills as files
If you prefer rules files committed to your repository over an MCP server, the packager CLI writes them directly. You can pick a single target or 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
You can also filter to a specific skill:
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
The full list of supported targets:
Repository layout
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, build-skills-catalog.mjs
└── skills/ upstream android/skills clone (gitignored)
The skills/ directory is a plain clone of android/skills and is gitignored. You only need it for development. Both published packages bundle a parsed snapshot of the skills inside dist/skills.json, so end users never need the upstream repository.
Development
Clone, install, and run the test suite:
git clone https://github.com/skydoves/android-skills-mcp.git
cd android-mcp
pnpm install
pnpm sync:skills
pnpm build
pnpm test
The build runs in topological order: core first, then mcp and pack in parallel. Each package has its own vitest suite. The full test count is 64 across the three packages.
You can smoke test the MCP server over stdio without any client:
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
Find this repository useful? :heart:
Support it by joining stargazers for this repository. :star: Also follow me for my next creations! 🤩
Trademarks
Android is a trademark of Google LLC. This project is not affiliated with, endorsed by, or sponsored by Google LLC. The skill content bundled in this project is redistributed from android/skills under the terms of its Apache 2.0 license. See NOTICE for complete attribution.
Claude, Cursor, GitHub Copilot, Gemini Code Assist, JetBrains Junie, Continue, and Aider are trademarks of their respective owners. This project mentions them to describe compatibility with their public extension mechanisms.
License
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.
