Mobile Principles
AThevon/genjutsu
Mobile-specific UX principles - touch targets, hover-less doctrine, thumb zones, safe areas, gestures, mobile perf budgets.
Apply swyx's native mobile UX preferences when designing or critiquing iPhone/iPad flows, adapting tablet layouts, choosing communication-app notification behavior, or opening notifications/deep…
Install Mobile Native
$ npx skills add swyxio/skills --skill mobile-native -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install swyxio/skills mobile-native --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/swyxio/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/mobile-native .claude/skills/mobile-native && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "mobile-native" agent skill from https://github.com/swyxio/skills/tree/main/mobile-native into .claude/skills/mobile-native/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-native", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/swyxio/skills/tree/main/mobile-nativeType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add swyxio/skills --skill mobile-native -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install swyxio/skills mobile-native --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swyxio/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/mobile-native .agents/skills/mobile-native && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "mobile-native" agent skill from https://github.com/swyxio/skills/tree/main/mobile-native into .agents/skills/mobile-native/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-native", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add swyxio/skills --skill mobile-native -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install swyxio/skills mobile-native --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swyxio/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/mobile-native .cursor/skills/mobile-native && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "mobile-native" agent skill from https://github.com/swyxio/skills/tree/main/mobile-native into .cursor/skills/mobile-native/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-native", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/swyxio/skills.git --path mobile-native--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add swyxio/skills --skill mobile-native -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install swyxio/skills mobile-native --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swyxio/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/mobile-native .gemini/skills/mobile-native && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "mobile-native" agent skill from https://github.com/swyxio/skills/tree/main/mobile-native into .gemini/skills/mobile-native/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-native", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install swyxio/skills mobile-nativeInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add swyxio/skills --skill mobile-native -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/swyxio/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/mobile-native .github/skills/mobile-native && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "mobile-native" agent skill from https://github.com/swyxio/skills/tree/main/mobile-native into .github/skills/mobile-native/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-native", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add swyxio/skills --skill mobile-native -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install swyxio/skills mobile-native --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swyxio/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/mobile-native .opencode/skills/mobile-native && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "mobile-native" agent skill from https://github.com/swyxio/skills/tree/main/mobile-native into .opencode/skills/mobile-native/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-native", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
mobile-native- GitHub stars
- 175
- Token cost
- ~1k tokens
- SKILL.md length
- 405 words
- Files
- 8 (incl. references)
- Skills in repo
- 89
- Repo updated
- First seen
- Licence
- MIT
At a glance
Apply swyx's native mobile UX preferences when designing or critiquing iPhone/iPad flows, adapting tablet layouts, choosing communication-app notification behavior, or opening notifications/deep…
- IOS/iPadOS generated build configuration
- SKILL.md covers Selective references, Personal defaults and Proportional completion
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Signing/install/launch problems
What it does
Mobile Native is an agent skill from swyxio/skills. Apply swyx's native mobile UX preferences when designing or critiquing iPhone/iPad flows, adapting tablet layouts, choosing communication-app notification behavior, or opening notifications/deep links/widgets/shortcuts before local content is ready. Also use for iOS/iPadOS generated build configuration, signing/install/launch problems, and device playtesting. Keep existing native or cross-platform stacks; excludes browser-only responsive work and backend-only changes without native UX or delivery implications.
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including reference files (for example `agents/openai.yaml`, `references/attention-notifications.md` and `references/clarifications.md`).
It sits in Mobile, covering Mobile UI design. It works with iOS. The repository describes itself as: Agent skills for Claude Code and other AI agents. The licence is MIT.
When your agent uses it
- IOS/iPadOS generated build configuration
- Signing/install/launch problems
- Device playtesting
Example prompts
- “/mobile-native”
What it can do on your machine
Read from SKILL.md and the folder at commit 038ef34. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Mobile Native loads about 1k tokens when it runs, and up to ~7.3k if it reads all its reference files. Until then it costs about 132 tokens; SKILL.md has 405 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from swyxio/skills at commit 038ef34, republished under its MIT licence (© swyxio). 405 words, ~1,013 tokens.
Download SKILL.mdSave it as
.claude/skills/mobile-native/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.- name
- mobile-native
- description
- Apply swyx's native mobile UX preferences when designing or critiquing iPhone/iPad flows, adapting tablet layouts, choosing communication-app notification behavior, or opening notifications/deep links/widgets/shortcuts before local content is ready. Also use for iOS/iPadOS generated build configuration, signing/install/launch problems, and device playtesting. Keep existing native or cross-platform stacks; excludes browser-only responsive work and backend-only changes without native UX or delivery implications.
Mobile Native
Native UX, implementation pitfalls, delivery, and playtesting belong together. Platform operations here cover iOS/iPadOS; Android procedures are not established.
Selective references
- UI/product choices: preferences and native UX. General aesthetics live in design-preferences.
- Generated configuration, signing, install, launch: iOS/iPadOS delivery.
- Device QA, XCTest, accessibility findings, screenshots: verification.
- External entry points before local content is ready: native UX.
- Importance, batching, AI recaps, notification text/actions and prefetch: attention.
- Material unresolved choices: clarifications. These notes are not an interview required before routine work.
Use mobile-webapp-ux for browser-only work. Image-led design exploration belongs
with design-apps-with-imagegen when selected; ordinary fixes need no mockup cycle.
Personal defaults
Design for a technical, busy mobile user: readable information density, important information and actions upfront, secondary capabilities progressively disclosed. Learn from relevant Superhuman, Slack, Linear, and platform patterns; verify current specifics before claiming how another app behaves.
Choose frameworks per product; retain the established stack in existing apps. Adapt iPad composition to window width, with sidebar/list-detail where useful. Recommend cached reading and durable offline actions only where the main task needs them; cached display alone does not establish offline mutation support.
For communication apps, combine explicit importance rules, model assistance, and user corrections. Respect existing preview settings. Batching cadence has no personal default: present rolling, scheduled, and in-app-only options when the product needs that decision.
For notifications, deep links, widgets, and shortcuts, show useful cached context immediately with an explicit indication of missing new content. Prioritize fetching the target, preserve exit/navigation, and recover automatically while its reader remains open; see the native UX reference.
Show full SKILL.md (149 more words)Show less
Proportional completion
Stop once the requested outcome, higher-level invariants, and risks introduced by the change are verified or explicitly reported as blocked/unavailable. Do not make adjacent improvements prerequisites or run a full mobile audit for a small fix. Use focused checks; physical devices matter for affected hardware/OS behavior or an explicit device-playtest request.
For delivery work, check the effective generated target and built artifact, then verify the requested installation/launch/distribution outcome. Build success, installation, ordinary launch, automation, and live delivery are separate claims. For touched interactions, inaccessible required content or controls prevent a claim that the flow is usable. Report unresolved audit findings without inventing a false-positive explanation; an audit does not become a universal release gate.
Record task evidence in the project's QA record. Update this skill only when asked; keep confirmed defaults separate from open choices. Do not accumulate private captures, credentials, device IDs, or signing-profile UUIDs here.
© swyxio, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 7 other files (references) in mobile-native of swyxio/skills.
- SKILL.md
- agents/openai.yaml
- references/attention-notifications.md
- references/clarifications.md
- references/ios-ipados-delivery.md
- references/native-ux.md
- references/preferences.md
- references/verification.md
Open the folder on GitHubat commit 038ef34
Compare with similar skills
Mobile Native next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Mobile Native this skillswyxio/skills | 175 | — | ~1k | Automated safety check: Pass | MIT | |
| Mobile PrinciplesAThevon/genjutsu | 424 | 1 repos | ~2.8k | Automated safety check: Pass | Custom licence | |
| Obsidian iOS Real Device Smokeedonyzpc/personal-assistant | 148 | — | ~4.5k | Automated safety check: Pass | AGPL-3.0 | |
| Mobile AccessibilityCommunity-Access/accessibility-agents | 422 | — | ~1.1k | Automated safety check: Pass | MIT | |
| Kb Mobile AccessibilityCommunity-Access/accessibility-agents | 422 | — | ~3.8k | Automated safety check: Pass | MIT | |
| Mobile DesignDokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI | 507 | — | ~510 | Automated safety check: Pass | Custom licence |
Similar skills
Obsidian iOS Real Device Smoke
edonyzpc/personal-assistant
Validate Personal Assistant on an iPhone using the iCloud test vault and Safari Web Inspector.
Mobile Accessibility
Community-Access/accessibility-agents
React Native, Expo, iOS and Android: labels, roles and touch targets.
Kb Mobile Accessibility
Community-Access/accessibility-agents
Reference data, not a reviewer. An agent skill from Community-Access/accessibility-agents.
Mobile Design
Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI
Mobile-first design thinking and decision-making for iOS and Android apps.
App Store Screenshots Generator
ParthJadhav/app-store-screenshots
Scaffolds a Next.js editor for designing App Store and Google Play screenshots as ads and exporting them at every required size, for iOS, Mac and Android.
More from swyxio/skills
All 89 skills in this repoProgrammatic Agents
swyxio/skills
Run a selected coding-agent CLI programmatically, with latency, error, usage, cost, and trace logging.
Reserved Handle Policy
swyxio/skills
Design, implement, audit, or refresh protected username and handle namespaces for public products.
New Mac Setup
swyxio/skills
Fully automated new Mac setup for fullstack web developers and AI engineers.
Youtube API
swyxio/skills
Manage YouTube videos programmatically via the YouTube Data API v3 — upload video files, upload custom thumbnails, update video metadata (titles, descriptions, tags), and query video/channel info…
Youtube Studio Batch Upload
swyxio/skills
Batch YouTube Studio upload workflow for videos sourced from Airtable, Google Drive, Loom, YouTube, or local files.
Deep Trajectory Analysis
swyxio/skills
Reconstruct and visually analyze paired agent, game, or policy trajectories to determine whether changed actions produced their intended effects.
Related
Works with
Categories
Questions about Mobile Native
What does Mobile Native do?
Apply swyx's native mobile UX preferences when designing or critiquing iPhone/iPad flows, adapting tablet layouts, choosing communication-app notification behavior, or opening notifications/deep…. Mobile Native is an agent skill from swyxio/skills. Apply swyx's native mobile UX preferences when designing or critiquing iPhone/iPad flows, adapting tablet layouts, choosing communication-app notification behavior, or opening notifications/deep links/widgets/shortcuts before local content is ready.
When should I use Mobile Native?
Mobile Native fits situations like: IOS/iPadOS generated build configuration; signing/install/launch problems; device playtesting.
How do I install Mobile Native in Claude Code?
Run `npx skills add swyxio/skills --skill mobile-native -a claude-code`. Or copy the skill folder (mobile-native in swyxio/skills) into .claude/skills/mobile-native in your project. Claude Code loads it when a task matches its description.
How do I install Mobile Native in Codex?
Run `npx skills add swyxio/skills --skill mobile-native -a codex`. Or copy the skill folder (mobile-native in swyxio/skills) into .agents/skills/mobile-native in your project. Codex loads it when a task matches its description.
Can I use Mobile Native in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add swyxio/skills --skill mobile-native -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mobile-native, .gemini/skills/mobile-native, .github/skills/mobile-native and .opencode/skills/mobile-native in your project.
What does Mobile Native need to run?
SKILL.md names no scripts, command-line tools or credentials: Mobile Native is instructions for the agent only.
Does Mobile Native access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Mobile Native safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Mobile Native use?
Mobile Native is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Mobile Native use?
About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6.3k tokens, read only when the agent opens those files.
What are the alternatives to Mobile Native?
Skills that share tags, products or a category with Mobile Native: Mobile Principles (AThevon/genjutsu, 424 stars), Obsidian iOS Real Device Smoke (edonyzpc/personal-assistant, 148 stars), Mobile Accessibility (Community-Access/accessibility-agents, 422 stars) and Kb Mobile Accessibility (Community-Access/accessibility-agents, 422 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Mobile Native?
swyxio (a GitHub user) maintains it in swyxio/skills, which has 175 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 5, 2026.
Source: swyxio/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.