Skip to content
Get packs

OpenCLI Adapter Author

Guides an agent to build or fix OpenCLI JS adapters that pull site data into CLI commands

Source Download skill
Repository
jackwener/OpenCLI
Stars
30,833
Licence
Apache-2.0
Files
15 files

What it does

This skill teaches an AI agent how to write or improve an OpenCLI adapter, a small JavaScript file that makes a website's data available as a command-line command. The agent first checks whether an existing adapter already does the job, then inspects the site's network requests and page state, and writes an adapter that returns business data. It also covers checking and testing the adapter, with reference notes on API discovery, output field design and decoding opaque fields.

Great for

  • Developers extending the OpenCLI project with new site commands
  • Maintainers repairing an existing OpenCLI adapter that broke after a site change
  • Engineers who want an agent to reverse-engineer a site's public or browser-visible API into a reusable CLI command

Skip it if

  • Ad-hoc browser clicking or one-off page interaction, which the skill says belongs to the separate opencli-browser skill
  • Running write actions (posts, purchases, edits) against a real account while testing, because the skill notes write commands have real effects and a test account or dry-run is needed
  • Scraping sites in ways their terms of service prohibit, since the skill does not address legal or policy limits

Try asking

  • “Build an OpenCLI adapter that searches items on example.com and returns JSON results”
  • “Check and test my existing adapter for the bilibili search command and fix pagination”
  • “Investigate the network requests on a site page to find a usable read API for a new command”
  • “Decode an opaque ID field in a site's response and document it in the adapter output”
Step-by-step guide: how to use OpenCLI Adapter AuthorInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the Apache-2.0 licence and an attribution note.

    opencli-adapter-author.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip opencli-adapter-author.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip opencli-adapter-author.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Start by running opencli list and reading existing adapters so the agent reuses neighboring code rather than writing from scratch
  • Test read commands with a real query, and use a dedicated test account before running any write command through adapter test
  • Review generated adapter code and any captured site data before committing, since the agent executes CLI commands and may send requests to the target site

What's inside

  • references/adapter-template.md
  • references/api-discovery.md
  • references/coverage-matrix.md
  • references/deep-recon.md
  • references/field-conventions.md
  • references/field-decode-playbook.md
  • references/jsdom-fixture-pattern.md
  • references/output-design.md
  • references/site-memory.md
  • references/site-memory/bilibili.md
  • references/site-memory/eastmoney.md
  • references/site-memory/gmail.md
  • references/site-memory/tonghuashun.md
  • references/site-memory/xueqiu.md
  • SKILL.md

Redistributed unmodified from jackwener/OpenCLI under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.