argent-lens skill: your agent builds several UI variants on a simulator and you pick one in a preview window
Has your agent build several versions of a UI element on a simulator and lets you pick the best one in a preview window.
- Installs
- 24.1K
- on skills.sh
- Stars
- 3.1K
- on GitHub
- Updated
- Oct 2026
- last repo commit
argent-lens is a skill from Software Mansion, part of its Argent toolkit that lets an assistant control iOS simulators, Android emulators and devices. You ask for design options, and the agent builds each variant in code, runs it on the device, takes a real screenshot, and stages it with propose_variant. A native window shows the variants next to the live simulator, you click your pick and add comments, and the agent applies your choice.
It needs the Argent tools, not just this skill, and a feature flag that is off by default. Run argent enable argent-lens once. The workflow also leans on Argent's simulator, emulator, React Native and device-interaction skills.
Good for
- Mobile developers comparing design options for a screen or component
- React Native teams who want to see real renders, not mockups
- Designers who want to choose from live variants and leave comments on the elements
Install argent-lens
Claude Code
- 1
Copy this prompt.
Install the argent-lens skill in Claude Code. Run this command: npx @swmansion/argent@latest init argent enable argent-lens Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js, An iOS simulator or Android emulator.
argent init is the README's install command. Its source (packages/argent-installer/src/init.ts) writes the MCP server config for the editors you pick, offers a tool auto-approval step, installs all Argent skills including argent-lens with the skills CLI (npx skills; offline it prints manual instructions instead), and copies rules and agents. Installing all skills also brings the sibling skills this one calls (argent-ios-simulator-setup, argent-android-emulator-setup, argent-device-interact, argent-react-native-app-workflow). The argent enable argent-lens step comes from the skill's own SKILL.md and from Argent's flag registry (packages/configuration-core/src/flags.ts): the Lens tools stay off until you run it. Pnpm users can run pnpm dlx @swmansion/argent@latest init.
From the project README. Source.
What's in the skill
When it loads
Propose multiple visual design variants for on-screen elements and let the human pick in the Argent Lens window. Use when the user asks for design alternatives / options / A-B choices for a screen or component, or any time you have produced more than one candidate look for an element and want a human decision before committing.
Sections in SKILL.md
- 1. Overview
- 2. Tools
- 3. Workflow
- Step 0: Plan the variants
- Step 1: Get a precise matcher
- Step 2: For each variant: build → navigate → screenshot → propose
- Step 3: Await the human's decision (once)
- Step 4: Apply the outcome
- 4. Rules
- 5. Example
Key facts
- Installs on skills.sh
- 24,071 (data from 2026-11-02)
- GitHub stars
- 3,138 for the whole argent repo (2026-11-02)
- Last repo commit
- 2026-10-31
What it includes
Decides which elements to redesign and what each variant is
Writes the list first, such as Search field: Filled, Outlined, Pill. Each variant is one self-contained change.
Try: “Give me three design options for the search field and two for the main button on the home screen.”
Read ·
Step 0: plan the variantsReads the element's label or identifier from the screen
Runs describe, or the React Native component tree, so the preview window anchors the card to the right element.
Read ·
Step 1: get a precise matcherEdits code, reloads the app, screenshots, stages each variant
For every variant the agent edits your code, reloads the React Native bundle or rebuilds, drives the app to the screen, takes a screenshot and calls propose_variant, then reverts the change. It must not crop or copy the screenshot.
Runs code ·
Step 2: build, navigate, screenshot, proposeStages one variant for one element, without blocking
Takes the element name, an optional matcher, the device id (udid) and the variant with name, summary and a preview image. Each element needs at least two variants.
Write ·
propose_variantWaits once for you to pick in the Argent Lens window
Returns your choices, unselected elements, pinned comments and a global comment. If it times out it returns pending and the agent waits again.
Read ·
await_user_selectionImplements the chosen variants and acts on your comments
The agent applies each chosen variant, addresses every comment, and reports what it applied and skipped.
Write ·
Step 4: apply the outcomeRun argent enable argent-lens once
SKILL.md says the workflow is off by default. If the tools come back not found, the flag is off.
Runs code ·
Feature flag
From the official docs
Permissions
Medium risk
The skill makes your agent edit your app code many times and drive a simulator or device, so an interrupted run could leave a variant in your files. Use a git branch and a simulator, not a personal device.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
argent init changes your editor setup
Per the installer source, init writes an MCP server entry into the config of each editor you choose, offers a tool auto-approval (allowlist) step, installs every Argent skill with npx skills, and copies rules and agents into the project or home folder. Decline auto-approval if you want to confirm each tool call, and check git status afterwards. github.com
It changes your code repeatedly
For every variant the agent edits code, rebuilds, screenshots and rolls the change back. If a run stops half way, a variant may be left in your files. Use a branch and check git status.
It controls a simulator or device
The Argent toolkit taps, types and navigates the device the agent uses. Point it at a simulator or test device, not one with personal accounts.
Argent collects telemetry by default
The privacy notice says telemetry is on by default and lists tool usage, install progress and environment data, not source code or file paths. Turn it off with argent telemetry disable.
Mixed licence
Source code is Apache-2.0 but the bundled binaries are proprietary. Read the README licence section.
Technical details
| Talks to | Argent telemetry (on by default, opt-out). npm and skills CLI downloads during argent init |
|---|---|
| Scopes |
|
Questions
What does argent-lens do?
It lets your agent offer you several real, on-device versions of a UI element and apply the one you choose. You pick in a preview window beside the live simulator stream.
How do I install it?
Use the install box at the top of this page. The skill needs the Argent tools, so installing the skill file alone is not enough. After installing, run argent enable argent-lens once.
Does it work without a simulator?
No. SKILL.md says each variant must be a real screenshot from a simulator, emulator or device, captured after that variant was applied. Mockups and guesses are not allowed.
Does it need an account or API key?
SKILL.md names none. Argent itself collects telemetry unless you turn it off with argent telemetry disable, per its README and privacy notice.
Can I use it commercially?
The source code is Apache-2.0, but the README says the bundled binaries are licensed solely for use within the Argent project and may not be reverse-engineered or redistributed. Read the licence before commercial use.
Is it safe?
It edits your app code for each variant and reverts it, reloads or rebuilds the app, and drives a simulator or device. Work on a branch and check git status when it finishes. Use a simulator rather than a personal phone.
Which platforms does it cover?
Argent's README lists iOS simulators, Android emulators and devices, TVs and Electron apps. SKILL.md points to setup skills for iOS simulators and Android emulators, and to a React Native workflow skill.
Information
updated Nov 2, 2026
- Repository
- software-mansion/argent
- Folder
packages/skills/skills/argent-lens
Sources
Docs, issue trackers and discussions this page is built from.
Show all 5Hide
- Argent README · github.com
- argent-lens SKILL.md · github.com
- argent init: skills step · github.com
- argent init · github.com
- Argent privacy notice · github.com