PlugWiki

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. 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. 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

  1. Evidence available to you
  2. JS interface
  3. Check and exercise
  4. 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 adapter

  • opencli 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 evidence

  • Public 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 strategy

  • opencli 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 adapter

  • adapter 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 test

  • Template, 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 toWebsites you point opencli browser at, through your Chrome
Scopes
  • Runs opencli and jsluice commands

  • Reads and edits files, including ~/.opencli/clis/<site>/<command>.js

  • Opens pages and reads network traffic in your Chrome through the OpenCLI extension

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

Folder
skills/opencli-adapter-author

jackwener/opencliskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3
  1. github.com · github.com
  2. github.com · github.com
  3. api-discovery.md · github.com

Updated Nov 2, 2026.