Updated 3d ago
by niki914
zafiro
Open-source BYOK AI agent for Android. Full phone control, native Shell & Python 3, with Skills and MCP support. Built with Material 3 Expressive. Works via Shizuku (root optional). Bring any provider: OpenRouter, Ollma, and more.
340 GitHub stars (340)
+113 in 30 days
| Period | New stars |
|---|---|
| Oct 1 | 0 |
| Oct 2 | 0 |
| Oct 3 | +1 |
| Oct 4 | +3 |
| Oct 5 | +3 |
| Oct 6 | +4 |
| Oct 7 | +3 |
| Oct 8 | 0 |
| Oct 9 | +4 |
| Oct 10 | +3 |
| Oct 11 | +6 |
| Oct 12 | +3 |
| Oct 13 | +4 |
| Oct 14 | +4 |
| Oct 15 | +6 |
| Oct 16 | +2 |
| Oct 17 | +6 |
| Oct 18 | +2 |
| Oct 19 | +3 |
| Oct 20 | +4 |
| Oct 21 | +7 |
| Oct 22 | +3 |
| Oct 23 | +4 |
| Oct 24 | +5 |
| Oct 25 | +5 |
| Oct 26 | +1 |
| Oct 27 | +6 |
| Oct 28 | +4 |
| Oct 29 | +3 |
| Oct 30 | +1 |
| Oct 31 | +3 |
| Nov 1 | +3 |
| Nov 2 | 0 |
| Nov 3 | +6 |
| Nov 4 | +6 |
| Nov 5 | +4 |
| Nov 6 | +5 |
- 20 skills (20 skills found in its SKILL.md files)
- 58 forks (58 forks)
- 3d ago last update (Last updated 3d ago)
Install
Skills CLI
npx skills add niki914/zafiro
Asks which skills and agents to install. Just one: npx skills add niki914/zafiro --skill add-worktree — add -g for every project.
Claude Code
git clone https://github.com/niki914/zafirocp -r "zafiro/.agents/skills/add-worktree" ~/.claude/skills/
Copies the add-worktree skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add niki914/zafiro
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
add-worktree
Use when the user wants to start work in a new git worktree — "new worktree", "spin up a worktree/branch for this", "work on X in another worktree", "branch this off". Allocates a reusable slot (<repo parent>/worktrees/zafiro/slot-X) off origin/main with a meaningful branch name.
.agents/skills/ on GitHub (opens in a new tab)add-worktree/ SKILL.md -
answer-me-with-html
Turns an answer into a one-page visual HTML explainer: the model writes a short Markdown draft and the bundled CLI builds one page. Use it proactively and liberally in replies to the user, without being asked, whenever a page would help the reader more than plain text, even if plain text would also work: any explanation of how something works or how parts relate (flow, request path, architecture,…
.agents/skills/ on GitHub (opens in a new tab)answer-me-with-html/ SKILL.md -
assistant-add-support
为语音助手宿主(如小布助手 Breeno 等)适配新版本 Xposed 接管支持。当用户要求支持新版本助手、适配助手应用更新、分析新版本 hook 点或解决宿主升级导致的接管失效时使用。
.agents/skills/ on GitHub (opens in a new tab)assistant-add-support/ SKILL.md -
extract-apk
定位、提取并反编译 Android APK:按关键字在设备上搜索包名、用 adb 导出 APK(含 split)、再用 jadx 反编译成可检索的源码树,并输出三个可预测的产物路径。当用户想拿到某个 App 的反编译代码、只知道 App 中文名/模糊名字、需要从已连接设备导出 APK,或需要把 APK 变成 sources/ 目录时使用。
.agents/skills/ on GitHub (opens in a new tab)extract-apk/ SKILL.md -
grill-me
A relentless interview to sharpen a plan or design.
.agents/skills/ on GitHub (opens in a new tab)grill-me/ SKILL.md -
grill-with-docs
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
.agents/skills/ on GitHub (opens in a new tab)grill-with-docs/ SKILL.md -
handoff
Compact the current conversation into a handoff document for another agent to pick up.
.agents/skills/ on GitHub (opens in a new tab)handoff/ SKILL.md -
host-command-bridge
Delegate heavy compilation/testing or opening visual artifacts on the host Mac from the Linux VM. Keep all other tasks inside the VM.
.agents/skills/ on GitHub (opens in a new tab)host-command-bridge/ SKILL.md -
proceed-video
处理并深度解析 UI 交互录屏视频。将原子动效视频切片为 4x4 网格对比图与左右残影对比图,并全方位拆解交互细节(光标变形、触发时机、物理曲线)及推荐前端复现技术栈。
.agents/skills/ on GitHub (opens in a new tab)proceed-video/ SKILL.md -
prompt-engineering
Guidelines to writing prompts, docs, or tasks for AI to read or execute, with strict context isolation.
.agents/skills/ on GitHub (opens in a new tab)prompt-engineering/ SKILL.md -
release-new-version
Use when the user wants to release a new Zafiro version — drafting bilingual release notes, deciding the next version number, bumping app/build.gradle.kts, tagging, and publishing to GitHub (main repo, optionally the Xposed repo).
.agents/skills/ on GitHub (opens in a new tab)release-new-version/ SKILL.md -
test-hang-watchdog
Prevent and diagnose hanging or long-running Gradle unit tests (> 30s) in Android/Kotlin coroutines codebases. Use when running tests, when a test execution takes unexpectedly long, when background test tasks appear frozen, or when taking thread dumps (jstack) to unblock coroutine deadlocks.
.agents/skills/ on GitHub (opens in a new tab)test-hang-watchdog/ SKILL.md -
test-triage
Use before writing, adding, or modifying any unit test in this repo — before creating a `*Test.kt` file or a `@Test` function, and before touching an existing test after a refactor. Triages whether the test should exist at all, and what must happen to it when the code it guards changes.
.agents/skills/ on GitHub (opens in a new tab)test-triage/ SKILL.md -
writing-for-agents
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
.agents/skills/ on GitHub (opens in a new tab)writing-for-agents/ SKILL.md -
zafiro-qa
针对 Zafiro Android 真机/模拟器进行 QA 测试与端到端验证。通过 Release 版提供的 Zafiro MCP 服务操控手机、截屏与验证 Tool 表现,结合 ADB 注入沙箱环境与拉取调试日志,验证 Debug 版功能。
.agents/skills/ on GitHub (opens in a new tab)zafiro-qa/ SKILL.md -
install-skill-from-github
Install a skill from a public GitHub repository onto this device. Use whenever the user pastes a GitHub URL or names a repo and wants a skill installed, imported, or updated, or asks to add a skill from GitHub — even if they only send a link. Covers finding SKILL.md in a repo, downloading it with python, and placing it under the skills root.
app/src/ on GitHub (opens in a new tab)main/ assets/ skills/ install-skill-from-github/ SKILL.md -
Phone Use
MUST Load this skill for ANY task that involves GUI interaction or device control — opening apps, tapping, typing, scrolling, swiping, Back/Home/Recents, reading the screen, or any workflow that touches on-screen content. Load this even when the user does not explicitly mention the device — if the task implies a GUI operation, load this skill first.
app/src/ on GitHub (opens in a new tab)main/ assets/ skills/ phone-use/ SKILL.md -
skill-creator
Create new skills, modify and improve existing skills, and measure skill performance. Use whenever the user wants to create a skill from scratch, turn a workflow or repeated task into a skill, edit or optimize an existing skill, test a skill with realistic prompts, or tune a skill's description so it triggers reliably — even if they don't say the word "skill".
app/src/ on GitHub (opens in a new tab)main/ assets/ skills/ skill-creator/ SKILL.md -
termux
Load this skill for anything involving Termux (com.termux) — first-time SSH setup, connecting to Termux, or a Termux connection that stopped working.
app/src/ on GitHub (opens in a new tab)main/ assets/ skills/ termux/ SKILL.md -
zafiro-config
Read or change Zafiro's own settings by editing the JSON files in its sandbox. Use this whenever the user asks to see, explain, change, add or remove Zafiro configuration — agent profiles, execution rules, takeover rules, MCP servers, custom Python tools, text actions, saved LLM configs, or app preferences such as theme and floating ball — and also when a Zafiro setting seems wrong, missing, or s…
app/src/ on GitHub (opens in a new tab)main/ assets/ skills/ zafiro-config/ SKILL.md
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.