@zenalexa/unicli 0.218.0 → 0.218.1

package/skills/unicli-smart-search/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: unicli-smart-search
+description: >
+  Route search queries to the best platform via unicli. Use when searching across
+  websites, social media, tech forums, news, finance, shopping, or academic sources.
+version: 1.0.0
+triggers:
+  - "search"
+  - "find information"
+  - "trending"
+  - "hot topics"
+  - "unicli search"
+allowed-tools: [Bash]
+protocol: 2.0
+---
+
+## When to Use
+
+Searching for information, checking trending topics, or gathering data across platforms.
+Commands return a v2 AgentEnvelope; pass `-f json` when you need JSON for parsing.
+
+## Pre-Check
+
+```bash
+unicli <site> --help                  # Verify subcommands exist
+unicli <site> <command> --help        # Check args and output columns
+```
+
+## Search Routing
+
+| Category     | Command                                                                                                                                                                                   |
+| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Web**      | `unicli google search <q>`, `unicli baidu search <q>`                                                                                                                                     |
+| **Tech**     | `unicli hackernews top`, `unicli hackernews search <q>`, `unicli stackoverflow hot`, `unicli lobsters hot`, `unicli v2ex hot`, `unicli linux-do hot`                                      |
+| **Social**   | `unicli twitter search <q>`, `unicli twitter trending`, `unicli reddit search <q>`, `unicli reddit hot`, `unicli weibo hot`, `unicli zhihu hot`, `unicli tieba hot`, `unicli threads hot` |
+| **Finance**  | `unicli xueqiu hot`, `unicli xueqiu hot-stock`, `unicli binance hot`, `unicli eastmoney hot`, `unicli bloomberg markets`, `unicli yahoo-finance search <q>`                               |
+| **Academic** | `unicli arxiv search <q>`, `unicli arxiv paper <id>`                                                                                                                                      |
+| **Shopping** | `unicli amazon search <q>`, `unicli jd search <q>`, `unicli taobao search <q>`, `unicli smzdm hot`, `unicli xianyu search <q>`                                                            |
+| **Video**    | `unicli bilibili hot`, `unicli bilibili search <q>`, `unicli youtube search <q>`, `unicli tiktok search <q>`                                                                              |
+| **News**     | `unicli toutiao hot`, `unicli 36kr hot`, `unicli bbc hot`, `unicli cnn top`, `unicli nytimes top`, `unicli reuters top`                                                                   |
+| **Dev**      | `unicli github-trending`, `unicli producthunt hot`, `unicli docker-hub search <q>`                                                                                                        |
+| **Reading**  | `unicli douban search <q>`, `unicli douban top250`, `unicli weread ranking`, `unicli wikipedia search <q>`                                                                                |
+| **Jobs**     | `unicli boss search <q>`, `unicli linkedin search <q>`, `unicli maimai search <q>`                                                                                                        |
+
+## Multi-Source Pattern
+
+For comprehensive research, query 2-3 complementary sources:
+
+```bash
+# Tech topic
+unicli hackernews search "LLM agents" --limit 10
+unicli reddit search "LLM agents" --limit 10
+unicli arxiv search "LLM agents" --limit 5
+
+# Chinese trending
+unicli weibo hot --limit 20
+unicli zhihu hot --limit 20
+
+# Market research
+unicli producthunt hot --limit 10
+unicli hackernews search "startup" --limit 10
+```
+
+## Output Handling
+
+```bash
+unicli hackernews top --limit 5 | jq '.[].title'
+unicli xueqiu hot | jq '.[] | {name, change}'
+```
+
+## Fallback
+
+- Exit 77 -> `unicli auth setup <site>` then retry
+- Exit 69 -> `unicli browser start` then retry
+- Exit 66 -> try different query terms
+- Site down -> switch to alternative from routing table
+
+## Budget
+
+Per question: 1-2 primary sources + 1 supplementary. Do not query same site twice.

package/skills/unicli-usage/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: unicli-usage
+description: >
+  Command reference and usage guide for unicli — the universal CLI for AI agents.
+  Use when you need to discover, run, or pipe unicli commands.
+---
+
+# unicli Usage Guide
+
+## Quick Reference
+
+```bash
+unicli list                           # List all available commands
+unicli list --type web-api            # Filter by adapter type
+unicli list --site bilibili           # Filter by site name
+
+unicli <site> <command> [options]     # Run any command
+unicli hackernews top --limit 5       # Example: HN top stories
+unicli hackernews search "AI agents"  # Example: search HN
+
+unicli doctor                         # System health check
+```
+
+## Output Formats
+
+All commands support `--format` / `-f`:
+
+| Format    | Use Case                            |
+| --------- | ----------------------------------- |
+| `md`      | Default v2 AgentEnvelope for agents |
+| `json`    | Machine parsing / jq                |
+| `yaml`    | Config-friendly envelope            |
+| `csv`     | Spreadsheet import                  |
+| `compact` | Pipe-friendly row stream            |
+
+```bash
+unicli hackernews top -f json | jq '.data[0].title'
+unicli hackernews top -f csv > stories.csv
+```
+
+## Adapter Types
+
+| Type      | Description              | Example              |
+| --------- | ------------------------ | -------------------- |
+| `web-api` | REST API calls           | hackernews, bilibili |
+| `desktop` | Local desktop software   | blender, gimp        |
+| `browser` | Full browser automation  | xiaohongshu          |
+| `bridge`  | Existing CLI passthrough | gh, docker           |
+| `service` | HTTP services            | ollama, comfyui      |
+
+## Exit Codes
+
+Use exit codes for scripting:
+
+```bash
+unicli hackernews top || echo "exit $?"
+[ $? -eq 77 ] && echo "Login required"
+```
+
+| Code | Meaning             |
+| ---- | ------------------- |
+| 0    | Success             |
+| 66   | Empty result        |
+| 69   | Service unavailable |
+| 77   | Auth required       |