From 8981343130af7ccb204b8e1f6e14323e3a0ed341 Mon Sep 17 00:00:00 2001 From: jackwener Date: Thu, 2 Apr 2026 19:17:19 +0800 Subject: [PATCH 1/3] fix(skills): add YAML frontmatter for discovery and improve descriptions - opencli-explorer: add missing frontmatter with name, description, tags - opencli-oneshot: add missing frontmatter with name, description, tags - opencli-usage: rewrite description to start with "Use when..." and include specific platform names for better keyword matching Root cause of low trigger rate: explorer and oneshot had no frontmatter at all, making them invisible to AI agent skill discovery. Usage had a generic description without triggering conditions. --- skills/opencli-explorer/SKILL.md | 6 ++++++ skills/opencli-oneshot/SKILL.md | 6 ++++++ skills/opencli-usage/SKILL.md | 4 ++-- 3 files changed, 14 insertions(+), 2 deletions(-) diff --git a/skills/opencli-explorer/SKILL.md b/skills/opencli-explorer/SKILL.md index 4d68faa2..e59fb298 100644 --- a/skills/opencli-explorer/SKILL.md +++ b/skills/opencli-explorer/SKILL.md @@ -1,3 +1,9 @@ +--- +name: opencli-explorer +description: Use when creating a new OpenCLI adapter from scratch, adding support for a new website or platform, or exploring a site's API endpoints via browser DevTools. Covers API discovery workflow, authentication strategy selection, YAML/TS adapter writing, and testing. +tags: [opencli, adapter, browser, api-discovery, cli, web-scraping, automation] +--- + # CLI-EXPLORER — 适配器探索式开发完全指南 > 本文档教你（或 AI Agent）如何为 OpenCLI 添加一个新网站的命令。 diff --git a/skills/opencli-oneshot/SKILL.md b/skills/opencli-oneshot/SKILL.md index bc2f71ba..c3419380 100644 --- a/skills/opencli-oneshot/SKILL.md +++ b/skills/opencli-oneshot/SKILL.md @@ -1,3 +1,9 @@ +--- +name: opencli-oneshot +description: Use when quickly generating a single OpenCLI command from a specific URL and goal description. 4-step process — open page, capture API, write YAML adapter, test. For full site exploration, use opencli-explorer instead. +tags: [opencli, adapter, quick-start, yaml, cli, one-shot, automation] +--- + # CLI-ONESHOT — 单点快速 CLI 生成 > 给一个 URL + 一句话描述，4 步生成一个 CLI 命令。 diff --git a/skills/opencli-usage/SKILL.md b/skills/opencli-usage/SKILL.md index 925b73a4..7c1f5710 100644 --- a/skills/opencli-usage/SKILL.md +++ b/skills/opencli-usage/SKILL.md @@ -1,9 +1,9 @@ --- name: opencli-usage -description: "OpenCLI usage guide — installation, prerequisites, and command reference organized by platform" +description: "Use when running OpenCLI commands to interact with websites (Bilibili, Twitter, Reddit, Xiaohongshu, etc.), desktop apps (Cursor, Notion), or public APIs (HackerNews, arXiv). Covers installation, command reference, and output formats for 60+ adapters." version: 1.5.9 author: jackwener -tags: [cli, browser, web, chrome-extension, cdp, AI, agent] +tags: [opencli, cli, browser, web, chrome-extension, cdp, bilibili, twitter, reddit, xiaohongshu, github, youtube, AI, agent, automation] --- # OpenCLI Usage Guide From 01fb7d5c1130bb11cae3ea91a43aa906bcbe7909 Mon Sep 17 00:00:00 2001 From: jackwener Date: Thu, 2 Apr 2026 19:22:41 +0800 Subject: [PATCH 2/3] fix(skills): add capability index, cross-skill links, and plugins entry - Add "Quick Lookup by Capability" table so agents can find platforms by what they need (search, trending, feed, AI chat, finance, etc.) - Add plugins.md entry to main index (was completely hidden) - Add "Related Skills" section linking to opencli-explorer and opencli-oneshot for adapter development - Compress platform listings for scannability --- skills/opencli-usage/SKILL.md | 50 +++++++++++++++++------------------ 1 file changed, 24 insertions(+), 26 deletions(-) diff --git a/skills/opencli-usage/SKILL.md b/skills/opencli-usage/SKILL.md index 7c1f5710..3060e72b 100644 --- a/skills/opencli-usage/SKILL.md +++ b/skills/opencli-usage/SKILL.md @@ -36,36 +36,34 @@ Browser commands require: Public API commands (`hackernews`, `v2ex`) need no browser. -## Command Categories - -OpenCLI commands are organized by platform type: +## Quick Lookup by Capability + +| Capability | Platforms (partial list) | File | +|-----------|--------------------------|------| +| **search** | Bilibili, Twitter, Reddit, Xiaohongshu, Zhihu, YouTube, Google, arXiv, LinkedIn, Pixiv, etc. | browser.md / public-api.md | +| **hot/trending** | Bilibili, Twitter, Weibo, HackerNews, Reddit, V2EX, Xueqiu, Lobsters, Douban | browser.md / public-api.md | +| **feed/timeline** | Twitter, Reddit, Xiaohongshu, Xueqiu, Jike, Facebook, Instagram, Medium | browser.md | +| **user/profile** | Twitter, Reddit, Instagram, TikTok, Facebook, Bilibili, Pixiv | browser.md | +| **post/create** | Twitter, Jike | browser.md | +| **AI chat** | Grok, Doubao, Kimi, DeepSeek, Qwen, ChatGPT, Cursor, Codex | browser.md / desktop.md | +| **finance/stock** | Xueqiu, Yahoo Finance, Barchart, Sina Finance, Bloomberg | browser.md / public-api.md | +| **web scraping** | `opencli web read --url ` — any URL to Markdown | browser.md | -### 📱 Browser-based Commands -Commands that require Chrome browser with login state. See [browser.md](./browser.md) for full reference. +## Command Categories -**Supported platforms:** -- Bilibili (哔哩哔哩), Zhihu (知乎), Xiaohongshu (小红书), Xueqiu (雪球) -- Twitter/X, Reddit, Facebook, Instagram, TikTok, LinkedIn -- YouTube, Medium, Substack, Sinablog (新浪博客) -- V2EX (browser features), Weibo (微博), Jike (即刻), Linux.do (browser features) -- BOSS直聘, Coupang (쿠팡), JD (京东), SMZDM (什么值得买), Ctrip (携程) -- Yahoo Finance, Sina Finance, Reuters, Barchart, Bloomberg (full article) -- Douban (豆瓣), Chaoxing (超星学习通), WeRead (微信读书), Pixiv -- Yollomi, Jimeng (即梦 AI), Web, Weixin (微信公众号) -- Grok, Doubao Web (豆包), Kimi, DeepSeek, Qwen (通义千问) +### 📱 Browser-based Commands (login required) +See [browser.md](./browser.md) — 40+ platforms including Bilibili, Twitter, Reddit, Xiaohongshu, YouTube, Instagram, TikTok, Facebook, LinkedIn, etc. ### 🖥️ Desktop Adapter Commands -Commands that interact with desktop applications via CDP or external CLI tools. See [desktop.md](./desktop.md) for full reference. +See [desktop.md](./desktop.md) — GitHub (gh CLI), Cursor, Codex, ChatGPT, ChatWise, Notion, Discord App, Doubao App, Antigravity. + +### 🌐 Public API Commands (no browser needed) +See [public-api.md](./public-api.md) — HackerNews, V2EX, Google, arXiv, Bloomberg RSS, StackOverflow, Wikipedia, etc. -**Supported platforms:** -- GitHub (via gh CLI), Cursor, Codex, ChatGPT, ChatWise -- Notion, Discord App, Doubao App (豆包桌面版), Antigravity +### 🔧 Management & AI Workflow +See [plugins.md](./plugins.md) — `opencli list`, `opencli validate`, `opencli explore`, `opencli record`, output formats, environment variables. -### 🌐 Public API Commands -Commands that work without browser or authentication. See [public-api.md](./public-api.md) for full reference. +## Related Skills -**Supported platforms:** -- Hacker News, V2EX (public features), BBC News, Sina Finance -- Lobsters, Google, DEV.to, Steam, Apple Podcasts -- arXiv, Bloomberg (RSS), Dictionary, HuggingFace -- StackOverflow, Xiaoyuzhou (小宇宙), Wikipedia, Product Hunt +- **opencli-explorer** — Full guide for creating new adapters (API discovery, auth strategy, YAML/TS writing) +- **opencli-oneshot** — Quick 4-step template for adding a single command from a URL From 405ad082988909d739ad9ded188d04c49c3f6bec Mon Sep 17 00:00:00 2001 From: jackwener Date: Thu, 2 Apr 2026 19:26:59 +0800 Subject: [PATCH 3/3] fix(skills): inline compact command quick-reference table in SKILL.md Add a self-contained command reference table directly in SKILL.md so agents that can only read the main skill file still have full command visibility. Each platform gets one row with all available commands. Organized into Browser/Desktop/Public API/Management sections. --- skills/opencli-usage/SKILL.md | 105 ++++++++++++++++++++++++++++++---- 1 file changed, 94 insertions(+), 11 deletions(-) diff --git a/skills/opencli-usage/SKILL.md b/skills/opencli-usage/SKILL.md index 3060e72b..2fb4c847 100644 --- a/skills/opencli-usage/SKILL.md +++ b/skills/opencli-usage/SKILL.md @@ -49,19 +49,102 @@ Public API commands (`hackernews`, `v2ex`) need no browser. | **finance/stock** | Xueqiu, Yahoo Finance, Barchart, Sina Finance, Bloomberg | browser.md / public-api.md | | **web scraping** | `opencli web read --url ` — any URL to Markdown | browser.md | -## Command Categories +## Command Quick Reference + +Usage: `opencli [args] [--limit N] [-f json|yaml|md|csv|table]` + +### Browser-based (login required) + +| Site | Commands | +|------|----------| +| **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `user-videos` `subtitle` `dynamic` `ranking` `following` | +| **zhihu** | `hot` `search` `question` | +| **xiaohongshu** | `search` `notifications` `feed` `user` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` | +| **xueqiu** | `hot-stock` `stock` `watchlist` `feed` `hot` `search` `earnings-date` `fund-holdings` `fund-snapshot` | +| **twitter** | `trending` `bookmarks` `search` `profile` `timeline` `thread` `article` `follow` `unfollow` `bookmark` `unbookmark` `post` `like` `reply` `delete` `block` `unblock` `followers` `following` `notifications` `hide-reply` `download` `accept` `reply-dm` | +| **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | +| **youtube** | `search` `video` `transcript` | +| **facebook** | `feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group` | +| **instagram** | `explore` `profile` `search` `user` `followers` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `saved` | +| **tiktok** | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` | +| **linkedin** | `search` `timeline` | +| **medium** | `feed` `search` `user` | +| **substack** | `feed` `search` `publication` | +| **sinablog** | `hot` `search` `article` `user` | +| **weibo** | `hot` | +| **boss** | `search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats` | +| **douban** | `search` `top250` `subject` `photos` `download` `marks` `reviews` | +| **pixiv** | `ranking` `search` `user` `illusts` `detail` `download` | +| **jike** | `feed` `search` `create` `like` `comment` `repost` `notifications` | +| **yahoo-finance** | `quote` | +| **barchart** | `quote` `options` `greeks` `flow` | +| **sinafinance** | `news` | +| **reuters** | `search` | +| **coupang** | `search` `add-to-cart` | +| **jd** | `item` | +| **smzdm** | `search` | +| **ctrip** | `search` | +| **weread** | `shelf` `search` `book` `highlights` `notes` `ranking` | +| **chaoxing** | `assignments` `exams` | +| **jimeng** | `generate` `history` | +| **yollomi** | `models` `generate` `video` `upload` `remove-bg` `edit` `background` `face-swap` `object-remover` `restore` `try-on` `upscale` | +| **web** | `read` — any URL to Markdown | +| **weixin** | `download` — 公众号 article to Markdown | +| **v2ex** (browser) | `daily` `me` `notifications` | +| **linux-do** (browser) | `categories` `category` | +| **bloomberg** (browser) | `news` — full article reader | +| **grok** | `ask` | +| **doubao** | `status` `new` `send` `read` `ask` | +| **kimi** | `status` `new` `ask` | +| **deepseek** | `status` `new` `ask` | +| **qwen** | `status` `new` `ask` | + +### Desktop (CDP/Electron) + +| Site | Commands | +|------|----------| +| **gh** | `repo` `pr` `issue` — passthrough to gh CLI | +| **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` | +| **codex** | `status` `send` `read` `new` `dump` `extract-diff` `model` `ask` `screenshot` `history` `export` | +| **chatgpt** | `status` `new` `send` `read` `ask` | +| **chatwise** | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` | +| **notion** | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` | +| **discord-app** | `status` `send` `read` `channels` `servers` `search` `members` | +| **doubao-app** | `status` `new` `send` `read` `ask` `screenshot` `dump` | +| **antigravity** | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` | + +### Public API (no browser) + +| Site | Commands | +|------|----------| +| **hackernews** | `top` `new` `best` `ask` `show` `jobs` `search` `user` | +| **v2ex** (public) | `hot` `latest` `topic` `node` `nodes` `member` `user` `replies` | +| **bbc** | `news` | +| **lobsters** | `hot` `newest` `active` `tag` | +| **google** | `news` `search` `suggest` `trends` | +| **devto** | `top` `tag` `user` | +| **steam** | `top-sellers` | +| **apple-podcasts** | `top` `search` `episodes` | +| **arxiv** | `search` `paper` | +| **bloomberg** (RSS) | `main` `markets` `tech` `politics` `economics` `opinions` `industries` `businessweek` `feeds` | +| **dictionary** | `search` `synonyms` `examples` | +| **hf** | `top` | +| **stackoverflow** | `hot` `search` `bounties` | +| **xiaoyuzhou** | `podcast` `podcast-episodes` `episode` | +| **wikipedia** | `search` `summary` | +| **producthunt** | `today` `week` `month` `search` | + +### Management -### 📱 Browser-based Commands (login required) -See [browser.md](./browser.md) — 40+ platforms including Bilibili, Twitter, Reddit, Xiaohongshu, YouTube, Instagram, TikTok, Facebook, LinkedIn, etc. - -### 🖥️ Desktop Adapter Commands -See [desktop.md](./desktop.md) — GitHub (gh CLI), Cursor, Codex, ChatGPT, ChatWise, Notion, Discord App, Doubao App, Antigravity. - -### 🌐 Public API Commands (no browser needed) -See [public-api.md](./public-api.md) — HackerNews, V2EX, Google, arXiv, Bloomberg RSS, StackOverflow, Wikipedia, etc. +```bash +opencli list [-f json|yaml] # List all commands +opencli validate [site] # Validate adapter definitions +opencli doctor # Diagnose browser bridge +opencli explore # AI-powered API discovery +opencli record # Record API calls manually +``` -### 🔧 Management & AI Workflow -See [plugins.md](./plugins.md) — `opencli list`, `opencli validate`, `opencli explore`, `opencli record`, output formats, environment variables. +All commands support: `--format` / `-f` with `table` `json` `yaml` `md` `csv` ## Related Skills