OpenCLI Adapter Author Skill: Turn a Website into a CLI Command with Claude
Guides Claude to write a reusable OpenCLI command for a website, using what the page actually does in your browser.
- Installs
- 16.3K
- on skills.sh
- Stars
- 30.8K
- on GitHub
- Files
- 18
- besides SKILL.md
- Updated
- Oct 2026
- last repo commit
OpenCLI Adapter Author makes Claude build or improve an OpenCLI adapter, a small JavaScript file that turns a website action into a command such as opencli example search. Claude first checks whether an adapter already exists, then looks at the site in your Chrome with network captures, picks the simplest reliable approach, writes the file and runs adapter check and adapter test.
It needs OpenCLI and its Chrome extension installed. Write commands do real things on the site, even during adapter test, so use a test account.
Good for
- Developers who want a repeatable command for a site that has no API
- OpenCLI users adding a command to an existing site adapter
- Contributors to the OpenCLI repo writing adapters under clis/
Install opencli-adapter-author
Claude Code
- 1
Copy this prompt.
Install the opencli-adapter-author skill in Claude Code. Run this command: npm install -g @jackwener/opencli Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js 20.18.1+.
The skill drives the opencli command, so install OpenCLI and its Chrome extension first. The README also offers OpenCLIApp, a desktop app that bundles the runtime. For ad-hoc browsing the skill points to opencli-browser, which you can add with --skill opencli-browser.
From the project README. Source.
What's in the skill
When it loads
Build or improve an OpenCLI JS adapter using observed site behavior, existing adapters and browser API evidence. For ad-hoc browser interaction, see opencli-browser.
Sections in SKILL.md
- Evidence available to you
- JS interface
- Check and exercise
- Optional references
Key facts
- Author
- jackwener
- License
- Apache-2.0
- Installs on skills.sh
- 16,325 (Nov 2, 2026)
- Last commit
- Oct 26, 2026
What it includes
opencli list --site and command help before writing anything
Claude lists commands for the site and reads their help. If one covers your need, no new adapter is written.
Runs code ·
Reuse an existing adapteropencli browser open, state, network and network --static
Claude opens the page in a named session, reads page state with diagnostics, and captures network requests. Static analysis adds API candidates from loaded scripts without running them.
Try: “Write an OpenCLI adapter for the top posts on this page.”
Runs code ·
Collect evidencePublic API, browser fetch, captured responses, page state or UI steps
Prefer a stable public API. Otherwise choose by observed reliability, and never guess endpoint parameters or hide failures behind empty results.
Read ·
Pick a strategyopencli adapter init, then a cli({...}) JavaScript file
Adapters are files under ~/.opencli/clis/<site>/<command>.js or the repo clis folder. Set access to read or write accurately and throw typed errors with a hint.
Write ·
Write the adapteradapter check, running the command, and adapter test with fixtures
check validates definitions without running them. test runs the real command and can compare to a fixture, with --trace retain-on-failure to debug browser runs.
Runs code ·
Check and testTemplate, API discovery, output design, field decoding, deep recon and site notes
Claude reads only what the task needs. Site notes and fixtures are optional, and older checklists are not mandatory.
Read ·
Optional references (18)
From the official docs
Permissions
Medium risk
Claude runs the opencli command against sites in your logged-in Chrome and writes adapter files on your machine. Use a test account for any command that changes data.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Write commands act on the real site
SKILL.md says write commands have real effects, including when run through adapter test. Use a test account or a dry run, and do not replay a write with an unknown outcome. github.com
It works inside your logged-in browser
The README says agents operate sites through your logged-in Chrome session. Close tabs with accounts you do not want Claude to touch, and use a separate Chrome profile if you can. github.com
It writes adapter files to your home folder
Adapters live in ~/.opencli/clis or the repo clis folder. Review the generated JavaScript before you run it on sites you care about. github.com
Optional jsluice scan of page scripts
SKILL.md allows Bash(jsluice:*). The reference guide says jsluice is an optional local tool that scans already-loaded script text passed on stdin, and that its hits are candidates to verify, not contracts. Do not store suspected secrets it finds. github.com
Technical details
| Talks to | Websites you point opencli browser at, through your Chrome |
|---|---|
| Scopes |
|
Questions
What does the opencli-adapter-author skill do?
It guides Claude through building a reusable OpenCLI adapter for a website: look for an existing one, gather evidence from the page, write the JavaScript file, then run check and test.
How do I install it?
Use the install box at the top of this page. The skill does nothing without the OpenCLI command and its Chrome extension, so install those first and run opencli doctor.
Do I need an API key?
No key is named in SKILL.md or the README quick start. OpenCLI works through your logged-in Chrome session, which is why you should be careful which accounts are signed in.
Is it safe to run?
It runs commands in your browser session and can run write commands on real sites. Use a test account, a separate Chrome profile and review each adapter before you use it.
What is the difference between this and opencli-browser?
SKILL.md says that for ad-hoc browser interaction you should see opencli-browser. The README describes opencli-browser as driving a real Chrome page to navigate, fill forms, click and extract, while this skill builds a reusable command.
Does it work in Cursor or Codex?
The README says to install the OpenCLI skills into your AI agent, naming Claude Code and Cursor as examples. It does not list other clients for this skill.
Information
updated Nov 2, 2026
- Repository
- jackwener/opencli
- Folder
skills/opencli-adapter-author
Sources
Docs, issue trackers and discussions this page is built from.
Show all 3Hide
- github.com · github.com
- github.com · github.com
- api-discovery.md · github.com