mobile-native
An agent skill by emilkowalski, from emilkowalski/skills. Tags: accessibility, mobile, performance, troubleshooting, ui-ux, web.
What it does
Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add emilkowalski/skills --skill mobile-native
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/emilkowalski/skills
cp -r skills/skills/mobile-native ~/.claude/skills/mobile-native
Safety box score
Grade A, minimal risk: 9 of 100 risk points, rated 2026-10-14. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This skill is a front-end/mobile CSS and meta-tag fix guide: it changes viewport, touch, scroll, safe-area, and theme-color behavior in the web app. It does not ship code or reach outside the project, but it can make broad site-wide UI changes and it explicitly requires real-device verification for several behaviors.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 0 (none) | The file contains only prose and CSS/HTML snippets; there are no shell commands, scripts, or code-evaluation steps. |
| Network access | 0 (none) | It does not download from or send data to remote hosts; the only remote-related content is static browser meta tags like `theme-color`. |
| Filesystem reach | 1 (low) | It directs edits to app-wide source files and global selectors such as `meta name="viewport"`, `html { ... }`, and `button, a { ... }`, so it can change the whole web app within the project. |
| Secrets & credentials | 0 (none) | There is no handling of tokens, keys, passwords, `.env` files, or browser/CLI logins. |
| Privilege & persistence | 0 (none) | It does not ask for sudo, global installs, services, scheduled tasks, or OS/shell configuration changes. |
| Instruction hijack surface | 1 (low) | The skill includes prompt-style behavior control and persona framing, e.g. `respond only with:` and `You are a senior design engineer`, which constrains the agent’s output but does not fetch or hide external instructions. |
| Irreversible actions | 0 (none) | It does not send messages, deploy, publish, pay, book, delete, or otherwise act outside the local web app edits it describes. |
| Transparency | 0 (none) | There are no binaries, minified blobs, base64 payloads, or unpinned remote installers. |
Before installing
- Read the app entry HTML/CSS first; confirm the viewport/theme-color/meta-tag changes are acceptable site-wide.
- Verify the project already uses real-device testing, since several fixes cannot be confirmed in emulation.
- Check for existing global rules on `html`, `body`, `user-select`, `touch-action`, and `overscroll-behavior` before merging.
- If the app is a PWA or has an installed mode, test that mode separately on a phone.
Rated 2026-10-14 by an automated review of 1 file from the skill's repository.
Source
- Repository
- emilkowalski/skills (all skills from this repository)
- Path
- skills/mobile-native/SKILL.md
- Branch
- main
- Updated
- 2026-09-22
Related skills
- apple-design — Apple's approach to interface design and fluid, physical motion, translated for the web.
- ask-sonner — Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating.
- antfu-design — antfu-style design conventions, broadened.
- frontend-visual-qa — Audits already-rendered web, landing-page, HTML deck/slide, browser tool/game, dashboard/admin, design-system.
- web-design-guidelines — Review UI code for Web Interface Guidelines compliance.
- app-platform-troubleshooting — Debug running App Platform applications by accessing containers, analyzing logs, running diagnostics, and applying fixes.