Skip to content

docs: document the skills subcommands in the CLI reference #200

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rajarshidattapy wants to merge 3 commits into
base: main
Choose a base branch
from
Open

docs: document the skills subcommands in the CLI reference #200

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
bd92aa9
fix: add missing commands to CLI reference documentation
rajarshidattapy Aug 4, 2026
1946174
Merge branch 'main' of https://github.com/agentrhq/webcmd into fix/cl…
rajarshidattapy Aug 4, 2026
2fd345a
docs: add skills section to CLI reference documentation
rajarshidattapy Aug 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 17 additions & 1 deletion docs/cli-reference.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,15 +62,18 @@ The old `web read` command has been renamed to `web fetch-browser`.
| `list` | Show registered built-in, user, plugin, and external commands. |
| `setup` | Choose local or hosted mode interactively. |
| `doctor` | Diagnose browser bridge and daemon connectivity. |
| `daemon` | Manage the local Webcmd daemon: status, stop, and restart. |
| `browser` | Agent-facing browser runtime for exploration and verification. |
| `web` | Local URL fetch and browser-backed page fetch helpers. |
| `profile` | List, rename, and select browser runtime profiles. |
| `auth` | Inspect website login status, and refresh logged-in site sessions. |
| `plugin` | Install, update, list, create, and uninstall plugins. |
| `adapter` | Eject, reset, and inspect local adapter overrides. |
| `external` | Register or install external local CLIs. |
| `validate` | Validate adapter definitions. |
| `verify` | Validate and smoke test an adapter. |
| `skills` | List and read bundled Webcmd agent skills. |
| `convention-audit` | Scan adapters for agent-native convention violations. |
| `skills` | List, add, update, and remove bundled Webcmd agent skills. |
| `completion` | Print shell completion scripts. |

## Output Formats
Expand Down Expand Up @@ -131,6 +134,19 @@ webcmd plugin install github:agentrhq/webcmd/plugins/ycombinator

Hosted mode supports the same `plugin search` and `plugin install` grammar for Webcmd-verified marketplace adapters. Other plugin management commands remain local-only in hosted mode.

## Skills

Bundled agent skills ship with the package. `webcmd skills add` links them into an agent harness and is part of first-time setup.

```bash
webcmd skills list
webcmd skills add
webcmd skills update
webcmd skills remove
```

On a TTY, `skills add` prompts for whichever of scope and harness you did not pass. Use `--scope <user|project>` and `--provider <agents|codex|claude>` to skip the prompts, or `--path <skills-dir>` to link into a custom directory. Outside a TTY, and with `--json`, it never prompts. Run `skills update` after upgrading the package to refresh the links.

## External CLIs

Agents can expose local tools through Webcmd, such as `gh`, `docker`, `vercel`, or internal CLIs.
Expand Down