docs(help): promote skills to the top of --help so agents discover them first (#1251)

The `Skills:` section was buried between `Setup:` and `Snapshot Options:` in
the top-level `--help`, where an agent skimming the output would pass over it
on the way to flag docs. Move it to a prominent "Start here (for AI agents)"
block directly below `Usage:` so it's the first thing an agent sees, and
reframe the copy so it conveys what skills *are* (workflow patterns, ref
usage, copy-paste examples) rather than just listing subcommand flags.

Skills are the intended entry point for agents. They ship with the CLI,
always version-match the installed binary, and cover both `agent-browser`
core usage and specialized workflows (Electron, Slack, exploratory testing,
cloud browser providers). Surfacing them up front prevents agents from
guessing commands out of flag docs when a hand-written workflow guide is
one command away.

No functional change. Only the ordering and wording of `--help` output.
This commit is contained in:
Chris Tate
2026-04-16 14:33:55 -05:00
committed by GitHub
parent 585d93a02b
commit 1afcaa0e84
+14 -6
View File
@@ -2853,6 +2853,20 @@ agent-browser - fast browser automation CLI for AI agents
Usage: agent-browser <command> [args] [options]
Start here (for AI agents):
agent-browser skills get agent-browser --full
Skills ship with the CLI (always version-matched) and include workflow
patterns, ref/selector usage, and copy-paste examples. Prefer this over
guessing commands from flag docs alone. Specialized skills cover Electron
apps, Slack, exploratory testing, and cloud browser providers.
skills [list] List available skills
skills get <name> Get a skill's core content (overview + examples)
skills get <name> --full Include references and templates
skills get --all Get every skill
skills path [name] Print skill directory path
Core Commands:
open <url> Navigate to URL
click <sel> Click element (or @ref)
@@ -2972,12 +2986,6 @@ Setup:
dashboard start Start the observability dashboard
profiles List available Chrome profiles
Skills:
skills [list] List available skills
skills get <name> [--full] Get skill content (--full includes references)
skills get --all Get all skill content
skills path [name] Print skill directory path
Snapshot Options:
-i, --interactive Only interactive elements
-c, --compact Remove empty structural elements