PlugWiki

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. 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. 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. 1. Overview
  2. 2. Tools
  3. 3. Workflow
  4. Step 0: Plan the variants
  5. Step 1: Get a precise matcher
  6. Step 2: For each variant: build → navigate → screenshot → propose
  7. Step 3: Await the human's decision (once)
  8. Step 4: Apply the outcome
  9. 4. Rules
  10. 5. Example

Key facts

Installs on skills.sh
24,071 (data from 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 variants

  • Reads 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 matcher

  • Edits 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, propose

  • Stages 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_variant

  • Waits 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_selection

  • Implements 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 outcome

  • Run 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 toArgent telemetry (on by default, opt-out). npm and skills CLI downloads during argent init
Scopes
  • Edits and reverts app source code for each variant

  • Reloads or rebuilds your app and drives the simulator, emulator or device

  • Takes screenshots and opens a native preview window

  • Needs Argent tools installed

  • argent init: writes editor MCP config, installs all Argent skills, copies rules and agents

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

Folder
packages/skills/skills/argent-lens

software-mansion/argentskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5
  1. Argent README · github.com
  2. argent-lens SKILL.md · github.com
  3. argent init: skills step · github.com
  4. argent init · github.com
  5. Argent privacy notice · github.com

Updated Nov 2, 2026.