opencli-usage — скилл для Claude Code: работа с OpenCLI
Учит агента искать команды OpenCLI, читать их схемы и разбирать ответы. Нужен, когда работа с сайтами и Chrome идёт через адаптеры.
npx skills add jackwener/OpenCLI --skill opencli-usage -a claude-codeЧто делает opencli-usage
Скилл описывает, как агенту обращаться к OpenCLI: искать команды по названию и описанию, смотреть их входные параметры через справку, разбирать результат. Поиск идёт по встроенным командам и адаптерам сразу, выдача компактная и постраничная — продолжение берётся через --offset <nextOffset>. Каталог адаптеров в контекст не сваливают.
Команды по умолчанию отвечают JSON вида {ok:true,data:...}. Ошибка даёт ненулевой код возврата и объект с кодом, сообщением и подсказкой; логи уходят в stderr. Форматы -f table|yaml|csv|md|plain доступны там, где они перечислены в справке команды. Если исход записи неизвестен, сначала смотрят состояние, а не повторяют действие.
Для страниц есть opencli browser open|state|close с --session, а нативные методы Chrome сессии не требуют. Профиль выбирается через --profile, список профилей даёт profile list, диагностику соединения — doctor. Адаптеры создаются и проверяются командами adapter init|check|test|status, тесты выполняют реальные команды и могут писать данные. Скиллу нужен установленный opencli в PATH — без него вызовы Bash не сработают.
Какие задачи решает
- найти команду OpenCLI по описанию задачи
- посмотреть входные параметры команды перед запуском
- разобрать JSON-ответ и код ошибки
- выбрать между адаптером сайта и инструментом Chrome
- проверить локальный адаптер перед публикацией
Примеры запросов агенту
- Найди в OpenCLI команду для поиска по GitHub и покажи её справку
- Открой https://example.com в сессии research и покажи состояние страницы
- Проверь адаптер example/search с аргументом query=hello
Как установить opencli-usage
1Через Skills CLI (Vercel)
npx skills add jackwener/OpenCLI --skill opencli-usage -a claude-code2Вручную: положить файлы
~/.claude/skills/opencli-usage/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/opencli-usage/
1Через Skills CLI (Vercel)
npx skills add jackwener/OpenCLI --skill opencli-usage -a codex2Вручную: положить файлы
.agents/skills/opencli-usage/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jackwener/OpenCLI --skill opencli-usage -a cursor2Вручную: положить файлы
.cursor/skills/opencli-usage/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jackwener/OpenCLI opencli-usage2Вручную: положить файлы
.github/skills/opencli-usage/SKILL.md1Через Skills CLI (Vercel)
npx skills add jackwener/OpenCLI --skill opencli-usage -a gemini-cli2Командой платформы
gemini skills install https://github.com/jackwener/OpenCLI --path skills/opencli-usageВручную: положить файлы
.devin/skills/opencli-usage/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jackwener/OpenCLI --skill opencli-usage -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о opencli-usage
Как установить opencli-usage в Claude Code?
Выполните npx skills add jackwener/OpenCLI --skill opencli-usage -a claude-code. Файл скилла окажется по пути ~/.claude/skills/opencli-usage/SKILL.md.
Что делает opencli-usage?
Показывает агенту, как искать команды OpenCLI, читать их схемы и трактовать результаты, включая ошибки и постраничную выдачу.
Что нужно, чтобы скилл заработал?
Установленный opencli в PATH: скилл разрешает вызовы Bash(opencli:*) и чтение файлов, а без самой утилиты эти вызовы не пройдут.
Исходный текст
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