Skip to content
Back to search

android-skills

One skill for Android work: android-ui, with two modes — UI (building, reconstructing, and polishing Android UIs) and security (auditing the Android UI/frontend layer). Works with OpenCode, Claude…

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/tamvanpr/android-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/tamvanpr/android-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tamvanpr--android-skills/badge.svg)](/listings/tamvanpr--android-skills)

HTML

<a href="/listings/tamvanpr--android-skills"><img src="/api/listings/tamvanpr--android-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Via npm / npx

# straight from the repo (no clone); requires python3 on the machine
npx tamvanpr/android-skills --help
npx tamvanpr/android-skills --target claude --project .
npx tamvanpr/android-skills --target cursor

Or install globally. A global `npm i -g` also auto-installs the skill into the OpenCode global config (`~/.config/opencode`) as long as `python3` is on PATH. Local installs and `npx` runs never write outside their target (set `ANDROID_SKILLS_SKIP_POSTINSTALL=1` to disable the global hook as well):

npm i -g android-skills

If `python3` is missing, the npm install still succeeds and prints a hint; install Python, then run `android-skills` once. For other agents or per-project installs, pass arguments:

android-skills --target codex --project .
android-skills --uninstall --target opencode

`android-skills` is a wrapper that runs `install.py` with the same arguments; the installer still needs `python3` on PATH.

Via git / ZIP

git clone https://github.com/tamvanpr/android-skills.git
cd android-skills
python3 install.py

Or from a ZIP: extract, enter the `android-skills` folder, then run `python3 install.py`.

Available flags: `--project DIR`, `--target`, `--link`, `--agents-md`, `--uninstall`, `--validate` (see `--help`).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 148 lines
  1. # Android Skills
  2. One skill for Android work: `android-ui`, with two modes — **UI** (building, reconstructing, and polishing Android UIs) and **security** (auditing the Android UI/frontend layer). Works with OpenCode, Claude Code, Codex CLI, Gemini CLI, GitHub Copilot, Cursor, and Windsurf.
  3. ## Installation
  4. ### Via npm / npx
  5. ```bash
  6. # straight from the repo (no clone); requires python3 on the machine
  7. npx tamvanpr/android-skills --help
  8. npx tamvanpr/android-skills --target claude --project .
  9. npx tamvanpr/android-skills --target cursor
  10. ```
  11. Or install globally. A global `npm i -g` also auto-installs the skill into the OpenCode global config (`~/.config/opencode`) as long as `python3` is on PATH. Local installs and `npx` runs never write outside their target (set `ANDROID_SKILLS_SKIP_POSTINSTALL=1` to disable the global hook as well):
  12. ```bash
  13. npm i -g android-skills
  14. ```
  15. If `python3` is missing, the npm install still succeeds and prints a hint; install Python, then run `android-skills` once. For other agents or per-project installs, pass arguments:
  16. ```bash
  17. android-skills --target codex --project .
  18. android-skills --uninstall --target opencode
  19. ```
  20. `android-skills` is a wrapper that runs `install.py` with the same arguments; the installer still needs `python3` on PATH.
  21. ### Via git / ZIP
  22. ```bash
  23. git clone https://github.com/tamvanpr/android-skills.git
  24. cd android-skills
  25. python3 install.py
  26. ```
  27. Or from a ZIP: extract, enter the `android-skills` folder, then run `python3 install.py`.
  28. Available flags: `--project DIR`, `--target`, `--link`, `--agents-md`, `--uninstall`, `--validate` (see `--help`).
  29. ## Supported agents
  30. | Target | Mechanism | Global location | Project location |
  31. |---|---|---|---|
  32. | `opencode` | skill folder + commands | `~/.config/opencode/` | `<project>/.opencode/` |
  33. | `claude` | skill folder | `~/.claude/skills/` | `<project>/.claude/skills/` |
  34. | `codex` | `AGENTS.md` instructions + `<root>/.android-skills/` | `~/.codex/` | `<project>/` |
  35. | `gemini` | `GEMINI.md` instructions + skill folder | `~/.gemini/` | `<project>/` |
  36. | `copilot` | `.github/copilot-instructions.md` + skill folder | — (project only) | `<project>/.github/` |
  37. | `cursor` | `.mdc` rules in `<root>/rules/` + skill folder | `~/.cursor/` | `<project>/.cursor/` |
  38. | `windsurf` | `.md` rules in `<root>/rules/` + skill folder | `~/.windsurf/` | `<project>/.windsurf/` |
  39. For `codex`, `gemini`, and `copilot`, the installer copies the skills into the skill folder and adds a managed instruction block (`<!-- android-skills:begin -->`) to the rules file. The block is removed automatically by `--uninstall`.
  40. For `cursor` and `windsurf`, the installer writes one rules file per skill (with `alwaysApply: false`) plus copies the skill folder so references and scripts remain accessible. If the agent's UI does not pick up the global rules, add them through the rules panel.
  41. OpenCode also reads `.claude/skills` and `~/.claude/skills`. Install into only one of the two locations, otherwise the same skill name is loaded twice (the installer prints a note when it detects this).
  42. Reinstalling overwrites the old version. To update: `git pull` then run `install.py` again (not needed when using `--link`). For the npm route, rerun `npx tamvanpr/android-skills ...` or `npm i -g` again.
  43. On Termux (Android), just install `python3` and `git` via `pkg install python git`. The global path stays `~/.config/opencode`.
  44. After installing, restart the OpenCode session. If a skill does not show up, check the folder name, the capitalization of `SKILL.md`, and the `skill` permission on the agent being used.
  45. ## Using it in OpenCode
  46. There are three ways:
  47. 1. **Automatic.** OpenCode shows the skill name and description to the agent, and the agent loads it via the `skill` tool when the request matches.
  48. 2. **`@` mention.** In OpenCode v2, type `@android-ui` in the prompt to load a skill manually. v1 does not have this feature; just ask "load the android-ui skill".
  49. 3. **Commands.** `/ui <screen|folder>` is an optional shortcut from the `opencode/commands` folder; the right mode is picked from the argument and context.
  50. Examples:
  51. ```text
  52. @android-ui
  53. Rework the settings screen. Keep all existing functionality and state.
  54. ```
  55. ```text
  56. @android-ui
  57. Audit frontend security on app/src/main, debug and release variants.
  58. Do not modify files; report findings and false positives.
  59. ```
  60. The skill ID follows the folder name (`android-ui`). Do not rename the `android-ui` folder.
  61. References and scripts are not loaded automatically. The skills instruct the agent to read relevant references and run scripts from the skill folder.
  62. ## Structure
  63. ```text
  64. android-skills/
  65. ├── android-ui/
  66. │ ├── SKILL.md
  67. │ ├── references/
  68. │ └── scripts/
  69. ├── opencode/
  70. │ └── commands/
  71. ├── bin/
  72. │ ├── android-skills.js (npm/npx wrapper)
  73. │ └── postinstall.js (global installs only)
  74. ├── tests/run_tests.py
  75. ├── package.json
  76. ├── install.py
  77. ├── README.md (English)
  78. └── README.id.md (Bahasa Indonesia)
  79. ```
  80. References and scripts are not loaded automatically when a skill is mentioned. The skills instruct the agent to read the relevant references and run the necessary scripts.
  81. ## Scripts
  82. ```bash
  83. python3 android-ui/scripts/lint_ui.py app/src/main
  84. python3 android-ui/scripts/contrast.py "#5B5D58" "#F7F7F5" # always quote hex colors
  85. python3 android-ui/scripts/validate_tokens.py "#3B5BA9" --package com.example.app
  86. # with --write: refuses to overwrite an existing Color.kt/Theme.kt unless --force
  87. python3 android-ui/scripts/scan.py app --format md --out security-report.md
  88. python3 android-ui/scripts/scan.py app --fail-on high
  89. ```
  90. The script paths above are relative to the extracted folder. After installing, run scripts via the skill installation path or the path OpenCode provides.
  91. ## Tests
  92. ```bash
  93. python3 install.py --validate # frontmatter + every referenced file exists
  94. python3 tests/run_tests.py # scripts + install/uninstall for all 7 targets
  95. ```
  96. Suppress a scanner finding with `// sec-ignore: RULE_ID reason` (a reason is required) and a lint rule with `// ui-ignore: RULE_ID reason`.
  97. `scan.py` exits 2 (not 0) when the path is wrong or holds no source files, so an empty scan is never reported as clean.
  98. ## Limitations
  99. - `scan.py` is pattern-based. It does not track data flow and may produce false positives or miss vulnerabilities.
  100. - `lint_ui.py` catches measurable violations; visual quality still requires human review.
  101. - Audit results do not guarantee the app is safe and are not a substitute for a pentest or backend review.
  102. - API recommendations can change. Verify the official documentation for the Android/AndroidX versions you use.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.