Agent skill

Use Appclaw Agent CLI

by appclawhq in appclawhq/AppClaw

Use the appclaw-agent CLI to directly open, inspect, and interact with a mobile app via terminal commands — without writing a YAML flow.

Apache-2.0Auto-check passedMobile

Install Use Appclaw Agent CLI

skills CLI
$ npx skills add appclawhq/AppClaw --skill use-appclaw-agent-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install appclawhq/AppClaw use-appclaw-agent-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/appclawhq/AppClaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/use-appclaw-agent-cli .claude/skills/use-appclaw-agent-cli && rm -rf skills-src

Use ~/.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/

Facts

Skill name
use-appclaw-agent-cli
GitHub stars
116
Token cost
~775 tokens
SKILL.md length
376 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Apache-2.0

At a glance

Use the appclaw-agent CLI to directly open, inspect, and interact with a mobile app via terminal commands — without writing a YAML flow.

  • Works in 6 steps: Verify that appclaw-agent is installed… → Use a descriptive named session for the… → Inspect with snapshot -i --json before… → …
  • This skill when the user asks to open an app
  • SKILL.md covers Scrolling — direction reference and Assertions must always be visual
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Use Appclaw Agent CLI is an agent skill from appclawhq/AppClaw. Use the appclaw-agent CLI to directly open, inspect, and interact with a mobile app via terminal commands — without writing a YAML flow. Trigger this skill when the user asks to open an app, tap or fill a UI element, check visibility, or perform any one-off device interaction that does not require a reusable flow file.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile. It works with Model Context Protocol. The repository describes itself as: AI-powered mobile automation agent — describe what you want in plain English, AppClaw reads the screen, reasons, and acts. LLM-agnostic, open-source, zero telemetry. The licence is Apache-2.0.

When your agent uses it

  • This skill when the user asks to open an app
  • Fill a UI element
  • Check visibility
  • Perform any one-off device interaction that does not require a reusable flow file

Example prompts

  • “/use-appclaw-agent-cli”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Verify that appclaw-agent is installed and run appclaw-agent help workflow.
  2. Use a descriptive named session for the task.
  3. Inspect with snapshot -i --json before choosing a target.
  4. Prefer returned @eN references or durable selectors for interaction.
  5. Request a new snapshot after each state-changing action.
  6. Use --vision only when explicitly requested or when visual targeting is required and configured.

What it can do on your machine

Read from SKILL.md and the folder at commit 9bbc6f1. 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

Use Appclaw Agent CLI loads about 775 tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 376 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~775

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 appclawhq/AppClaw at commit 9bbc6f1, republished under its Apache-2.0 licence (© appclawhq). 376 words, ~775 tokens.

Download SKILL.mdSave it as .claude/skills/use-appclaw-agent-cli/SKILL.md (or your agent's skills folder).
name
use-appclaw-agent-cli
description
Use the appclaw-agent CLI to directly open, inspect, and interact with a mobile app via terminal commands — without writing a YAML flow. Trigger this skill when the user asks to open an app, tap or fill a UI element, check visibility, or perform any one-off device interaction that does not require a reusable flow file.

AppClaw Agent CLI

When the user asks you to operate or inspect a mobile device interactively (open an app, tap a button, check visibility, etc.) using terminal commands rather than a YAML flow:

  1. Verify that appclaw-agent is installed and run appclaw-agent help workflow.
  2. Use a descriptive named session for the task.
  3. Inspect with snapshot -i --json before choosing a target.
  4. Prefer returned @eN references or durable selectors for interaction.
  5. Request a new snapshot after each state-changing action.
  6. Use --vision only when explicitly requested or when visual targeting is required and configured.

Scrolling — direction reference

Always use scroll, never swipe. scroll and swipe are aliases in the parser, but scroll reads unambiguously — scroll down means scroll down, scroll up means scroll up.

GoalCommand
See content below (scroll down)appclaw-agent --session <name> scroll down --json
See content above (scroll up)appclaw-agent --session <name> scroll up --json
Scroll down within an elementappclaw-agent --session <name> scroll @eN down --json
Scroll up within an elementappclaw-agent --session <name> scroll @eN up --json

Never use swipe — swipe up is ambiguous (training data says it scrolls down; AppClaw treats it as scroll up). Using scroll eliminates the confusion entirely.

Never use swipe @eN direction — element-scoped swipe crashes (swipeElement is not a function). Use scroll @eN direction instead. 7. Close the named session when the task is complete.

Show full SKILL.md (148 more words)Show less

Assertions must always be visual

Never use DOM presence (is visible, snapshot element checks) as the sole assertion. The DOM may contain elements that are off-screen, scrolled out of view, or clipped — DOM presence does not mean the user can see it.

For every assertion or verification step:

  1. Take a screenshot: appclaw-agent --session <name> screenshot /tmp/<name>.png
  2. Read the screenshot image with the Read tool and visually analyze what is actually rendered on screen.
  3. Base your pass/fail verdict only on what you can see in the screenshot, not on DOM presence.
  4. If the target content is not clearly visible in the screenshot, the assertion fails — even if a DOM element exists for it.

This applies to any check phrased as "verify X is present", "confirm X appears", "assert X is visible", or similar.

The installed CLI help is the source of truth for supported commands.

© appclawhq, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/use-appclaw-agent-cli of appclawhq/AppClaw.

Open the folder on GitHubat commit 9bbc6f1

Compare with similar skills

Use Appclaw Agent CLI 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.

Use Appclaw Agent CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Use Appclaw Agent CLI this skillappclawhq/AppClaw116—~775Automated safety check: PassApache-2.0
Marionette Flutter Drive Appleancodepl/marionette_mcp473—~11kAutomated safety check: PassApache-2.0
Deep Linksstacklok/toolhive-studio170—~1.6kAutomated safety check: NotesApache-2.0
Asc Aso AuditCamilleScholtz/swmpc2396 repos~2.6kAutomated safety check: PassEUPL-1.2
Maui Devflow Uitestsnalu-development/nalu245—~2.3kAutomated safety check: PassCustom licence
Convex Insightsopenclaw/clawhub9.5k1 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Marionette Flutter Drive App

    leancodepl/marionette_mcp

    Set up and drive a running Flutter app (debug or profile) with Marionette — an AI agent's hands and eyes for the app.

    473 GitHub stars~11k tokensUpdated 2 days ago
    MobileAuto-check passed
  • Deep Links

    stacklok/toolhive-studio

    Deep links in ToolHive Studio. An agent skill from stacklok/toolhive-studio.

    170 GitHub stars~1.6k tokensUpdated yesterday
    MobileAuto-check: notes
  • Asc Aso Audit

    CamilleScholtz/swmpc

    Run an offline ASO audit on canonical App Store metadata under ./Store and surface keyword gaps using Astro MCP.

    239 GitHub starsUsed in 6 repos~2.6k tokens
    MobileAuto-check passed
  • Maui Devflow Uitests

    nalu-development/nalu

    How to write, run and debug automated UI tests for the Nalu.Maui component libraries using .NET MAUI DevFlow (in-app agent + Driver + CLI + MCP).

    245 GitHub stars~2.3k tokensUpdated 3 days ago
    MobileAuto-check passed
  • Convex Insights

    openclaw/clawhub

    Query a running Convex app's logs + health in natural language (official MCP): failures, slow/expensive functions, deploy causality — scoped, evidence-backed, with a dashboard deep link.

    9.5k GitHub starsUsed in 1 repo~1.1k tokens
    MobileAuto-check passed
  • Add Theme Icons

    r0adkll/Campfire

    Add new AppTheme.Icon entries by pulling Icons8 icons (Arcade style by default) and converting them to Compose ImageVectors via the Valkyrie CLI.

    140 GitHub stars~1.2k tokensUpdated today
    MobileAuto-check passed

More from appclawhq/AppClaw

  • Generate Appclaw Flow

    appclawhq/AppClaw

    Generate YAML flow files for AppClaw mobile automation. An agent skill from appclawhq/AppClaw.

    116 GitHub stars~3.4k tokensUpdated 1 mo ago
    Auto-check: notes
  • Review Changes

    appclawhq/AppClaw

    Review code changes in the AppClaw repo for correctness, CLI/VSCode extension consistency, and YAML flow parsing regressions.

    116 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Use Appclaw CLI

    appclawhq/AppClaw

    Use the AppClaw CLI to run YAML flows, start the interactive TUI shell, explore apps, record/replay sessions, configure devices, and troubleshoot.

    116 GitHub stars~4.6k tokensUpdated 1 mo ago
    Auto-check: notes

Categories

Questions about Use Appclaw Agent CLI

What does Use Appclaw Agent CLI do?

Use the appclaw-agent CLI to directly open, inspect, and interact with a mobile app via terminal commands — without writing a YAML flow. Use Appclaw Agent CLI is an agent skill from appclawhq/AppClaw. Use the appclaw-agent CLI to directly open, inspect, and interact with a mobile app via terminal commands — without writing a YAML flow.

When should I use Use Appclaw Agent CLI?

Use Appclaw Agent CLI fits situations like: this skill when the user asks to open an app; fill a UI element; check visibility; perform any one-off device interaction that does not require a reusable flow file.

How do I install Use Appclaw Agent CLI in Claude Code?

Run `npx skills add appclawhq/AppClaw --skill use-appclaw-agent-cli -a claude-code`. Or copy the skill folder (.agents/skills/use-appclaw-agent-cli in appclawhq/AppClaw) into .claude/skills/use-appclaw-agent-cli in your project. Claude Code loads it when a task matches its description.

How do I install Use Appclaw Agent CLI in Codex?

Run `npx skills add appclawhq/AppClaw --skill use-appclaw-agent-cli -a codex`. Or copy the skill folder (.agents/skills/use-appclaw-agent-cli in appclawhq/AppClaw) into .agents/skills/use-appclaw-agent-cli in your project. Codex loads it when a task matches its description.

Can I use Use Appclaw Agent CLI 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 appclawhq/AppClaw --skill use-appclaw-agent-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/use-appclaw-agent-cli, .gemini/skills/use-appclaw-agent-cli, .github/skills/use-appclaw-agent-cli and .opencode/skills/use-appclaw-agent-cli in your project.

What does Use Appclaw Agent CLI need to run?

SKILL.md names no scripts, command-line tools or credentials: Use Appclaw Agent CLI is instructions for the agent only.

Does Use Appclaw Agent CLI 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 Use Appclaw Agent CLI 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 Use Appclaw Agent CLI use?

Use Appclaw Agent CLI is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Use Appclaw Agent CLI use?

About 775 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Use Appclaw Agent CLI?

Skills that share tags, products or a category with Use Appclaw Agent CLI: Marionette Flutter Drive App (leancodepl/marionette_mcp, 473 stars), Deep Links (stacklok/toolhive-studio, 170 stars), Asc Aso Audit (CamilleScholtz/swmpc, 239 stars) and Maui Devflow Uitests (nalu-development/nalu, 245 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Use Appclaw Agent CLI?

appclawhq (a GitHub organization) maintains it in appclawhq/AppClaw, which has 116 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on September 3, 2026.

Source: appclawhq/AppClaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.