opencli-usage — Claude Code skill: driving OpenCLI
Teaches an agent to find OpenCLI commands, read their schemas and parse results. Useful when site and Chrome work goes through adapters.
npx skills add jackwener/OpenCLI --skill opencli-usage -a claude-codeWhat opencli-usage does
The skill spells out how an agent should use OpenCLI: search commands by name and description, inspect their inputs through command help, interpret the output. Search covers built-ins and adapters at once, and results come back compact and paginated — continue with --offset <nextOffset>. The adapter catalog is not dumped into context.
Commands answer in JSON by default: {ok:true,data:...}. A failure returns a nonzero exit code plus an object with code, message and hint; logs go to stderr. The -f table|yaml|csv|md|plain exports exist where command help lists them. When a write outcome is unknown, inspect state before repeating the action.
Page work runs through opencli browser open|state|close with --session, while native Chrome methods need no session. --profile picks a connected Chrome profile, profile list discovers them, doctor diagnoses the connection. Adapters are created and checked with adapter init|check|test|status; adapter tests execute real commands and can write. The skill needs opencli on PATH — without it the Bash calls never run.
What it helps with
- find an OpenCLI command for a task
- check a command's inputs before running it
- read a JSON result and an error code
- choose between a site adapter and a Chrome tool
- verify a local adapter before shipping it
Example prompts for the agent
- Find the OpenCLI command for searching GitHub and show its help
- Open https://example.com in session research and show the page state
- Test the example/search adapter with query=hello
How to install opencli-usage
1Skills CLI (Vercel)
npx skills add jackwener/OpenCLI --skill opencli-usage -a claude-code2Manually: put the files in place
~/.claude/skills/opencli-usage/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/opencli-usage/
1Skills CLI (Vercel)
npx skills add jackwener/OpenCLI --skill opencli-usage -a codex2Manually: put the files in place
.agents/skills/opencli-usage/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jackwener/OpenCLI --skill opencli-usage -a cursor2Manually: put the files in place
.cursor/skills/opencli-usage/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jackwener/OpenCLI opencli-usage2Manually: put the files in place
.github/skills/opencli-usage/SKILL.md1Skills CLI (Vercel)
npx skills add jackwener/OpenCLI --skill opencli-usage -a gemini-cli2Platform CLI
gemini skills install https://github.com/jackwener/OpenCLI --path skills/opencli-usageManually: put the files in place
.devin/skills/opencli-usage/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jackwener/OpenCLI --skill opencli-usage -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about opencli-usage
How do I install opencli-usage in Claude Code?
Run npx skills add jackwener/OpenCLI --skill opencli-usage -a claude-code. The skill file lands at ~/.claude/skills/opencli-usage/SKILL.md.
What does opencli-usage do?
It shows the agent how to search OpenCLI commands, read their schemas and interpret results, including errors and paginated output.
What does the skill need to work?
opencli on PATH. The skill allows Bash(opencli:*) and Read, so without the CLI those calls fail.
Source text
SKILL.md · Apache-2.0
---
name: opencli-usage
description: Discover and invoke OpenCLI capabilities for websites and Chrome. Find commands, inspect schemas, interpret results and choose browser or adapter tools.
allowed-tools: Bash(opencli:*), Read
---
# OpenCLI
OpenCLI exposes reusable website adapters and direct Chrome tools to agents.
```sh
opencli list search
opencli list --site github --limit 20
opencli github search --help -f json
```
`list [query]` searches command names and descriptions across built-ins and adapters.
Results are compact and paginated: `{ok:true,data:{commands,total,nextOffset?}}`.
Pass `--offset <nextOffset>` to continue. Inspect exact inputs using command help.
Do not hard-code the adapter catalog or dump all commands into context.
## Results
Commands default to JSON: `{ok:true,data:...}`. Failures produce a nonzero exit
code and `{ok:false,error:{code,message,hint?,...}}` on stdout. Logs use stderr.
Explicit `-f table|yaml|csv|md|plain` exports are available where command help lists
them. Help, version, completion and explicit plain exports retain their own formats.
Browser follow modes stream one JSON envelope per line.
Use error codes and supplied candidates/keys to recover. Unknown write outcomes
require inspecting state before repeating an action. An empty successful result
is distinct from an execution failure.
## Browser
```sh
opencli browser open https://example.com --session research
opencli browser state --session research
opencli browser close --session research
opencli browser chrome describe
```
Page commands use `--session`; native Chrome methods need no session. `--profile`
selects a connected Chrome profile. `profile list` discovers profiles and
`profile use <name>` selects the default. Use `doctor` for connection diagnosis.
See `opencli-browser` for interaction, API evidence and tab/group management.
## Adapters and installation
```sh
opencli adapter init example/search
opencli adapter check example/search
opencli adapter test example/search --args '{"query":"hello"}'
opencli adapter status
```
See `opencli-adapter-author` for implementation. `adapter eject` makes an official
site editable locally; `adapter reset` removes that local override. Adapter tests
execute real commands and can perform writes.
`plugin list|install|update|uninstall|create` manages plugin packages. `auth status`
reports website login facts; `auth refresh` touches sessions. `daemon status|restart|stop`
manages the bridge process. Read help for the selected capability.
Bundled skill content is available through `skills list` and
`skills read opencli-browser -f plain` (omit `-f plain` for JSON).
© jackwener · Apache-2.0 · jackwener/OpenCLI
