android / android/skills

[Bug] android-cli: incorrect android CLI command names

Open Beginner friendly
#139 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
7.3k
Forks
476
Avg merge
8h 59m
Merged PRs (30d)
7

Description

### Affected Skill
`devtools/android-cli`

### Description
The skill references two commands that don't exist in the actual `android` CLI:
- `SKILL.md` → "Capturing screenshots" section says to use `android screenshot`.
- `references/interact.md` (two occurrences) says to use `android screen --annotate`.

The real command is `android screen capture`, and `--annotate` is a flag on the `capture` subcommand, not on `screen` itself.

### Expected Behavior
Following the documented commands should successfully capture / annotate a screenshot.

### Actual Behavior
```
$ android screenshot
android 'screenshot' is not a valid command. See android --help
Did you mean: android screen or android create or android describe?

$ android screen --annotate
Unknown option: '--annotate'
Usage: android screen [-h] [COMMAND]
```

### Steps to Reproduce
CLI version `1.0.15985488`.
1. Install the `devtools/android-cli` skill.
2. Run `android screenshot` as instructed in `SKILL.md` → fails.
3. Run `android screen --annotate` as instructed in `interact.md` → fails.
4. `android screen capture --annotate` succeeds and writes a PNG.

### Suggested Fix
- `SKILL.md` "Capturing screenshots": `android screenshot` → `android screen capture`
- `interact.md` (both occurrences): `android screen --annotate` → `android screen capture --annotate`

Contributor guide

Open the contributing guide

Research direction

Update the command examples in devtools/android-cli/SKILL.md and devtools/android-cli/references/interact.md, including both occurrences in the latter. Compare them with the reported working commands, then verify that the screenshot and annotation instructions use android screen capture and android screen capture --annotate.

Written by the indexing model from the issue text.

Assessment

Tech stack
android
Domain
cli, documentation
Issue type
Bug
Difficulty
1/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
88/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.