felo-ai 0.2.11 → 0.2.12

package/CHANGELOG.md

@@ -5,6 +5,10 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.12] - 2026-03-102
+
+Streamline the process and reduce the need for confirmation and selection.
+
 ## [0.2.10] - 2026-03-10
 
 ### Fixed

package/README.md

@@ -2,7 +2,7 @@
 
 **Ask anything. Get current answers. Generate slides from a prompt.**
 
-[npm package: **felo-ai**](https://www.npmjs.com/package/felo-ai) — Real-time search, PPT generation, web page extraction, YouTube subtitles, and X (Twitter) search from the terminal. Also works as Claude Code skills. Supports Chinese, English, Japanese, and Korean.
+[npm package: **felo-ai**](https://www.npmjs.com/package/felo-ai) - Real-time search, PPT generation, web page extraction, YouTube subtitles, and X (Twitter) search from the terminal. Also works as Claude Code skills. Supports Chinese, English, Japanese, and Korean.
 
 [![npm version](https://img.shields.io/npm/v/felo-ai.svg)](https://www.npmjs.com/package/felo-ai) [![License](https://img.shields.io/badge/license-MIT-green)]()
 
@@ -43,21 +43,21 @@ export FELO_API_KEY="your-api-key-here"
 $env:FELO_API_KEY="your-api-key-here"
 ```
 
-Get your API key from [felo.ai](https://felo.ai) (Settings → API Keys). Environment variable overrides config if both are set.
+Get your API key from [felo.ai](https://felo.ai) (Settings > API Keys). Environment variable overrides config if both are set.
 
 ### Commands
 
-| Command                              | Description                                           |
-| ------------------------------------ | ----------------------------------------------------- |
-| `felo search "<query>"`              | Search for current info (weather, news, prices, etc.) |
-| `felo slides "<prompt>"`             | Generate PPT; returns link when done                 |
-| `felo web-fetch --url <url>`       | Fetch webpage content (markdown/text/html)          |
-| `felo youtube-subtitling -v <url-or-id>` | Fetch YouTube video subtitles by video URL or ID   |
-| `felo x "<query>"`                       | Search X (Twitter) tweets, users, and replies       |
-| `felo config set FELO_API_KEY <key>` | Save API key to config                                |
-| `felo config get FELO_API_KEY`       | Print stored key                                      |
-| `felo config list`                   | List config keys                                      |
-| `felo config path`                   | Show config file path                                 |
+| Command                                  | Description                                           |
+| ---------------------------------------- | ----------------------------------------------------- |
+| `felo search "<query>"`                  | Search for current info (weather, news, prices, etc.) |
+| `felo slides "<prompt>"`                 | Generate PPT; returns link when done                  |
+| `felo web-fetch --url <url>`             | Fetch webpage content (markdown/text/html)            |
+| `felo youtube-subtitling -v <url-or-id>` | Fetch YouTube video subtitles by video URL or ID      |
+| `felo x "<query>"`                       | Search X (Twitter) tweets, users, and replies         |
+| `felo config set FELO_API_KEY <key>`     | Save API key to config                                |
+| `felo config get FELO_API_KEY`           | Print stored key                                      |
+| `felo config list`                       | List config keys                                      |
+| `felo config path`                       | Show config file path                                 |
 
 ### Examples
 
@@ -97,16 +97,16 @@ node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --read
 
 **How to pass parameters**
 
-| Parameter | CLI option | Example | Description |
-|-----------|------------|---------|--------------|
-| URL (required) | `-u`, `--url` | `--url "https://example.com"` | Page to fetch |
-| Output format | `-f`, `--format` | `--format text` or `-f markdown` | `html`, `text`, or `markdown` (default: markdown) |
-| Target element | `--target-selector` | `--target-selector "article.main"` | CSS selector; only this element is fetched |
-| Wait for element | `--wait-for-selector` | `--wait-for-selector ".content"` | Wait for selector before fetching (e.g. dynamic pages) |
-| Readability | `--readability` | `--readability` | Main article content only (no nav/ads) |
-| Crawl mode | `--crawl-mode` | `--crawl-mode fine` | `fast` (default) or `fine` |
-| Timeout (seconds) | `-t`, `--timeout` | `--timeout 120` or `-t 90` | Request timeout (default: 60) |
-| Full JSON response | `-j`, `--json` | `-j` or `--json` | Print full API response instead of content only |
+| Parameter          | CLI option            | Example                            | Description                                            |
+| ------------------ | --------------------- | ---------------------------------- | ------------------------------------------------------ |
+| URL (required)     | `-u`, `--url`         | `--url "https://example.com"`      | Page to fetch                                          |
+| Output format      | `-f`, `--format`      | `--format text` or `-f markdown`   | `html`, `text`, or `markdown` (default: markdown)      |
+| Target element     | `--target-selector`   | `--target-selector "article.main"` | CSS selector; only this element is fetched             |
+| Wait for element   | `--wait-for-selector` | `--wait-for-selector ".content"`   | Wait for selector before fetching (e.g. dynamic pages) |
+| Readability        | `--readability`       | `--readability`                    | Main article content only (no nav/ads)                 |
+| Crawl mode         | `--crawl-mode`        | `--crawl-mode fine`                | `fast` (default) or `fine`                             |
+| Timeout (seconds)  | `-t`, `--timeout`     | `--timeout 120` or `-t 90`         | Request timeout (default: 60)                          |
+| Full JSON response | `-j`, `--json`        | `-j` or `--json`                   | Print full API response instead of content only        |
 
 Examples with multiple options:
 
@@ -177,13 +177,31 @@ This repo also provides **Claude Code** skills. If you use [Claude Code](https:/
 
 ### Quick Start (Search skill)
 
-Install the skill:
+**Quick Start**: Using the npm [skills](https://www.npmjs.com/package/skills) CLI:
 
 ```bash
-npx @claude/skills add felo-search
+npx skills add Felo-Inc/felo-skills --skill felo-search
 ```
 
-Get your API key from [felo.ai](https://felo.ai) (Settings → API Keys), then configure:
+Or manually copy to the skills directory:
+
+**Linux/macOS:**
+
+```bash
+git clone https://github.com/Felo-Inc/felo-skills.git && cd felo-skills
+cp -r felo-search ~/.claude/skills/
+```
+
+**Windows (PowerShell):**
+
+```powershell
+git clone https://github.com/Felo-Inc/felo-skills.git; cd felo-skills
+Copy-Item -Recurse felo-search "$env:USERPROFILE\.claude\skills\"
+```
+
+See [Manual installation](#manual-installation) for details.
+
+Get your API key from [felo.ai](https://felo.ai) (Settings > API Keys), then configure:
 
 **Linux/macOS:**
 
@@ -207,7 +225,7 @@ Ask Claude: "What's the weather in Tokyo today?"
 
 **You're done!** The skill triggers automatically for any question needing current information.
 
-**Felo Slides (PPT):** In terminal run `felo slides "your topic"`. In Claude Code install with `npx @claude/skills add felo-slides`, then use `/felo-slides your topic`. See [felo-slides](./felo-slides/README.md).
+**Felo Slides (PPT):** In terminal run `felo slides "your topic"`. In Claude Code install with `npx skills add Felo-Inc/felo-skills --skill felo-slides`, then use `/felo-slides your topic`. See [felo-slides](./felo-slides/README.md).
 
 **Felo Web Fetch:** In terminal run `felo web-fetch --url "https://example.com"` (see [felo-web-fetch](./felo-web-fetch/README.md)). In Claude Code you can install the skill and use it to fetch webpage content from a URL.
 
@@ -276,7 +294,7 @@ Claude: [Recent AI breakthroughs, company announcements]
 
 Works in Chinese (Simplified & Traditional), Japanese, Korean, and English. Ask in any language, get answers in that language.
 
-**[See 40+ more examples →](./docs/EXAMPLES.md)**
+**[See 40+ more examples >](./docs/EXAMPLES.md)**
 
 ---
 
@@ -290,7 +308,7 @@ Works in Chinese (Simplified & Traditional), Japanese, Korean, and English. Ask
 
 ### Manual installation
 
-If quick install doesn’t work:
+If you don't want to use `npx skills add` or don't have the skills CLI, you can install it manually:
 
 1. Clone this repository:
 
@@ -312,7 +330,7 @@ If quick install doesn’t work:
    Copy-Item -Recurse felo-search "$env:USERPROFILE\.claude\skills\"
    ```
 
-3. Get API key from [felo.ai](https://felo.ai) (Settings → API Keys)
+3. Get API key from [felo.ai](https://felo.ai) (Settings > API Keys)
 
 4. Set environment variable (see Quick Start)
 
@@ -326,7 +344,7 @@ claude skills list
 
 You should see `felo-search` in the output.
 
-Test: ask Claude _"Latest news about quantum computing"_. If you see an AI-generated answer, it’s working.
+Test: ask Claude _"Latest news about quantum computing"_. If you see an AI-generated answer, it's working.
 
 ---
 
@@ -350,7 +368,7 @@ Test: ask Claude _"Latest news about quantum computing"_. If you see an AI-gener
 
 ### Q: "INVALID_API_KEY" error?
 
-**A:** Your API key is incorrect or revoked. Generate a new one at [felo.ai](https://felo.ai) (Settings → API Keys).
+**A:** Your API key is incorrect or revoked. Generate a new one at [felo.ai](https://felo.ai) (Settings > API Keys).
 
 ### Q: Does it work in Chinese/Japanese/Korean?
 
@@ -366,9 +384,9 @@ Test: ask Claude _"Latest news about quantum computing"_. If you see an AI-gener
 
 ### Q: How fast are responses?
 
-**A:** Typically 2–5 seconds depending on query complexity.
+**A:** Typically 2-5 seconds depending on query complexity.
 
-**[Full FAQ →](./docs/FAQ.md)**
+**[Full FAQ >](./docs/FAQ.md)**
 
 ---
 
@@ -387,19 +405,19 @@ Real-time web search with AI-generated answers.
 - Product comparisons
 - Any question with "latest", "recent", "best", "how to"
 
-**[View skill documentation →](./felo-search/)**
+**[View skill documentation >](./felo-search/)**
 
 ### felo-slides
 
-Generate PPT: in terminal use `felo slides "your topic"`, in Claude Code use `/felo-slides your topic`. **[View skill documentation →](./felo-slides/)**
+Generate PPT: in terminal use `felo slides "your topic"`, in Claude Code use `/felo-slides your topic`. **[View skill documentation >](./felo-slides/)**
 
 ### felo-web-fetch
 
-Fetch and extract webpage content: in terminal use `felo web-fetch --url "https://example.com"`, in Claude Code use `/felo-web-fetch https://example.com`. **[View skill documentation →](./felo-web-fetch/)**
+Fetch and extract webpage content: in terminal use `felo web-fetch --url "https://example.com"`, in Claude Code use `/felo-web-fetch https://example.com`. **[View skill documentation >](./felo-web-fetch/)**
 
 ### felo-x-search
 
-Search X (Twitter) tweets, users, and replies: in terminal use `felo x "query"`, in Claude Code use `/felo-x-search query`. **[View skill documentation →](./felo-x-search/SKILL.md)**
+Search X (Twitter) tweets, users, and replies: in terminal use `felo x "query"`, in Claude Code use `/felo-x-search query`. **[View skill documentation >](./felo-x-search/SKILL.md)**
 
 ---
 
@@ -413,36 +431,36 @@ We welcome contributions:
 
 Run CLI tests: `npm test`
 
-**[Contributing guide →](./CONTRIBUTING.md)**
+**[Contributing guide >](./CONTRIBUTING.md)**
 
 ---
 
 ## Links
 
-- **[npm: felo-ai](https://www.npmjs.com/package/felo-ai)** — CLI package
-- **[Felo Open Platform](https://openapi.felo.ai/docs/)** — Get your API key
-- **[API Documentation](https://openapi.felo.ai/docs/api-reference/v2/chat.html)** — API reference
-- **[Claude Code](https://claude.ai/code)** — AI assistant CLI
-- **[Full examples](./docs/EXAMPLES.md)** — 40+ usage examples
-- **[FAQ](./docs/FAQ.md)** — Troubleshooting
-- **[GitHub Issues](https://github.com/Felo-Inc/felo-skills/issues)** — Report bugs
+- **[npm: felo-ai](https://www.npmjs.com/package/felo-ai)** - CLI package
+- **[Felo Open Platform](https://openapi.felo.ai/docs/)** - Get your API key
+- **[API Documentation](https://openapi.felo.ai/docs/api-reference/v2/chat.html)** - API reference
+- **[Claude Code](https://claude.ai/code)** - AI assistant CLI
+- **[Full examples](./docs/EXAMPLES.md)** - 40+ usage examples
+- **[FAQ](./docs/FAQ.md)** - Troubleshooting
+- **[GitHub Issues](https://github.com/Felo-Inc/felo-skills/issues)** - Report bugs
 
 ---
 
 ## Publishing to npm (maintainers)
 
-自动发布由 GitHub Actions 在**推送 tag** 时执行（参考 [editablejs/editable](https://github.com/editablejs/editable/blob/main/.github/workflows/main.yml) 的流程思路）。
+This project uses GitHub Actions to automatically publish when **pushing a tag** (referencing the [editablejs/editable](https://github.com/editablejs/editable/blob/main/.github/workflows/main.yml) publishing workflow).
 
-1. **配置 NPM_TOKEN**  
-   在 [npm Access Tokens](https://www.npmjs.com/account/tokens) 创建 **Automation** 类型、具备 Publish 权限的 token，在仓库 **Settings → Secrets and variables → Actions** 里添加名为 `NPM_TOKEN` 的 secret。
+1. **Configure NPM_TOKEN**
+   Generate an **Automation** type Publish token in [npm Access Tokens](https://www.npmjs.com/account/tokens). Add a secret named `NPM_TOKEN` in the repository's **Settings > Secrets and variables > Actions**.
 
-2. **发布新版本**  
-   更新 `package.json` 的 `version`，提交并推送，然后打 tag 并推送：
+2. **Publish a new version**
+   Update the `version` in `package.json`, then commit and push the tag:
    ```bash
    git tag v0.2.8
    git push origin v0.2.8
    ```
-   CI 会跑测试并通过 `npm publish` 发布到 [npm](https://www.npmjs.com/package/felo-ai)。
+   CI will automatically run `npm publish` to publish to [npm](https://www.npmjs.com/package/felo-ai).
 
 ---
 
@@ -456,13 +474,13 @@ Run CLI tests: `npm test`
 
 ## Version history
 
-See [CHANGELOG.md](./CHANGELOG.md) for release notes (e.g. breaking changes such as `web-extract` → `web-fetch` in v0.2.7).
+See [CHANGELOG.md](./CHANGELOG.md) for release notes (e.g. breaking changes such as `web-extract` -> `web-fetch` in v0.2.7).
 
 ---
 
 ## License
 
-MIT — see [LICENSE](./felo-search/LICENSE) in the repo for details.
+MIT - see [LICENSE](./felo-search/LICENSE) in the repo for details.
 
 ---
 

package/docs/FAQ.md

@@ -18,21 +18,25 @@ Quick answers to common questions about Felo Search skill.
 
 **A:** Install Node.js first.
 
-Download from [nodejs.org](https://nodejs.org) and install. Then retry:
+Download from [nodejs.org](https://nodejs.org) and install. 然后可用一键安装：
+
 ```bash
-npx @claude/skills add felo-search
+npx skills add Felo-Inc/felo-skills --skill felo-search
 ```
 
+若失败，请使用 [README 中的手动安装](https://github.com/Felo-Inc/felo-skills#manual-installation)：将 `felo-search` 复制到 `~/.claude/skills/`（Windows: `%USERPROFILE%\.claude\skills\`）。
+
 ### Q: Permission denied during install
 
-**A:** Use elevated privileges.
+**A:** 若复制目录时权限不足，可用一键安装（无需 sudo）：
 
-**Linux/macOS:**
 ```bash
-sudo npx @claude/skills add felo-search
+npx skills add Felo-Inc/felo-skills --skill felo-search
 ```
 
-**Windows:** Run PowerShell or CMD as Administrator.
+**Linux/macOS 手动复制：** 确保 `~/.claude/skills/` 存在且有写权限后执行 `cp -r felo-search ~/.claude/skills/`。
+
+**Windows：** 若复制到 `%USERPROFILE%\.claude\skills\` 失败，请以管理员身份运行 PowerShell。
 
 ### Q: Skill not showing up after install
 

package/felo-search/README.md

@@ -32,10 +32,26 @@ Felo Search integrates [Felo AI](https://felo.ai) into Claude Code, enabling:
 
 ### Step 1: Install
 
+**一键安装（推荐）：**
+
+```bash
+npx skills add Felo-Inc/felo-skills --skill felo-search
+```
+
+**手动安装：** 若上述命令不可用，可克隆本仓库后将 `felo-search` 复制到 Claude Code 的 skills 目录：
+
+**Linux/macOS:**
 ```bash
-npx @claude/skills add felo-search
+cp -r felo-search ~/.claude/skills/
 ```
 
+**Windows (PowerShell):**
+```powershell
+Copy-Item -Recurse felo-search "$env:USERPROFILE\.claude\skills\"
+```
+
+(Clone this repo first if needed: `git clone https://github.com/Felo-Inc/felo-skills.git`.)
+
 **Verify:** Restart Claude Code and run:
 ```bash
 claude skills list

package/felo-search/SKILL.md

@@ -64,48 +64,18 @@ For permanent configuration, add it to your shell profile (~/.bashrc, ~/.zshrc)
 
 ## How to Execute
 
-When this skill is triggered, execute the following steps using the Bash tool:
-
-### Step 1: Check API Key
-
-Use the Bash tool to verify the API key is set:
-
-```bash
-if [ -z "$FELO_API_KEY" ]; then
-  echo "ERROR: FELO_API_KEY not set"
-  exit 1
-fi
-echo "API key configured"
-```
-
-If the API key is not set, inform the user with setup instructions and STOP.
-
-### Step 2: Make API Request
-
-Extract the user's query and call the Felo API using a temporary JSON file to handle special characters:
+When this skill is triggered, execute the search script using the Bash tool:
 
 ```bash
-# Create query JSON (replace USER_QUERY with actual query)
-cat > /tmp/felo_query.json << 'EOF'
-{"query": "USER_QUERY_HERE"}
-EOF
-
-# Call Felo API
-curl -s -X POST https://openapi.felo.ai/v2/chat \
-  -H "Authorization: Bearer $FELO_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d @/tmp/felo_query.json
-
-# Clean up
-rm -f /tmp/felo_query.json
+~/.agents/skills/felo-search/scripts/search.sh "USER_QUERY_HERE"
 ```
 
 **Notes:**
 - Replace `USER_QUERY_HERE` with the actual user query
-- Use heredoc (`cat > file << 'EOF'`) to properly handle Chinese, Japanese, and special characters
-- Use `-s` flag with curl for clean output
+- The script handles API key validation, JSON escaping, and API calls
+- Supports all special characters, Unicode (Chinese, Japanese, etc.), and quotes
 
-### Step 3: Parse and Format Response
+### Parse and Format Response
 
 The API returns JSON with this structure:
 ```json
@@ -115,7 +85,7 @@ The API returns JSON with this structure:
 }
 ```
 
-Parse the JSON response and present it to the user in this format:
+Present the response to the user in this format:
 
 ```
 ## Answer
@@ -144,16 +114,7 @@ Optimized search terms: Tokyo weather today, 東京 天気 今日
 
 **Bash command:**
 ```bash
-cat > /tmp/felo_query.json << 'EOF'
-{"query": "What's the weather in Tokyo today?"}
-EOF
-
-curl -s -X POST https://openapi.felo.ai/v2/chat \
-  -H "Authorization: Bearer $FELO_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d @/tmp/felo_query.json
-
-rm -f /tmp/felo_query.json
+~/.agents/skills/felo-search/scripts/search.sh "What's the weather in Tokyo today?"
 ```
 
 ### Example 2: Local news / events
@@ -171,16 +132,7 @@ Optimized search terms: Hangzhou recent news, Hangzhou events, 杭州 最近 新
 
 **Bash command:**
 ```bash
-cat > /tmp/felo_query.json << 'EOF'
-{"query": "What's new in Hangzhou recently"}
-EOF
-
-curl -s -X POST https://openapi.felo.ai/v2/chat \
-  -H "Authorization: Bearer $FELO_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d @/tmp/felo_query.json
-
-rm -f /tmp/felo_query.json
+~/.agents/skills/felo-search/scripts/search.sh "What's new in Hangzhou recently"
 ```
 
 ### Example 3: Travel / things to do
@@ -189,16 +141,7 @@ rm -f /tmp/felo_query.json
 
 **Bash command:**
 ```bash
-cat > /tmp/felo_query.json << 'EOF'
-{"query": "What are the best things to do in Taipei"}
-EOF
-
-curl -s -X POST https://openapi.felo.ai/v2/chat \
-  -H "Authorization: Bearer $FELO_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d @/tmp/felo_query.json
-
-rm -f /tmp/felo_query.json
+~/.agents/skills/felo-search/scripts/search.sh "What are the best things to do in Taipei"
 ```
 
 ### Example 4: Restaurants / recommendations
@@ -207,16 +150,7 @@ rm -f /tmp/felo_query.json
 
 **Bash command:**
 ```bash
-cat > /tmp/felo_query.json << 'EOF'
-{"query": "Popular restaurants in Tokyo"}
-EOF
-
-curl -s -X POST https://openapi.felo.ai/v2/chat \
-  -H "Authorization: Bearer $FELO_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d @/tmp/felo_query.json
-
-rm -f /tmp/felo_query.json
+~/.agents/skills/felo-search/scripts/search.sh "Popular restaurants in Tokyo"
 ```
 
 ## Error Handling
@@ -279,7 +213,7 @@ To use this skill, you need to set up your Felo API Key:
 - This skill should be used for any question requiring current information
 - Execute immediately using the Bash tool - don't just describe what you would do
 - Multi-language support: Fully supports Simplified Chinese, Traditional Chinese (Taiwan), Japanese, and English
-- Handle special characters properly: Use heredoc for JSON files to avoid encoding issues
+- Handle special characters properly: Use the search script which handles JSON escaping via sed
 - Parse JSON response: Extract answer and query_analysis fields
 - Format nicely: Present results in a clean, readable format with proper markdown
 - The API returns results in the same language as the query when possible

package/felo-search/scripts/search.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+set -e
+
+# Cross-platform compatibility
+if ! command -v curl &> /dev/null; then
+  echo "ERROR: curl is required but not installed"
+  exit 1
+fi
+
+# Check if API key is set
+if [ -z "$FELO_API_KEY" ]; then
+  echo "ERROR: FELO_API_KEY not set"
+  echo ""
+  echo "To use this skill, you need to set up your Felo API Key:"
+  echo ""
+  echo "1. Get your API key from https://felo.ai (Settings → API Keys)"
+  echo "2. Set the environment variable:"
+  echo ""
+  echo "   Linux/macOS/WSL:"
+  echo "   export FELO_API_KEY=\"your-api-key-here\""
+  echo ""
+  echo "   Windows (PowerShell):"
+  echo "   \$env:FELO_API_KEY=\"your-api-key-here\""
+  echo ""
+  echo "   Windows (CMD):"
+  echo "   set FELO_API_KEY=your-api-key-here"
+  echo ""
+  echo "3. Restart Claude Code or reload the environment"
+  exit 1
+fi
+
+# Get query from first argument
+QUERY="$1"
+
+if [ -z "$QUERY" ]; then
+  echo "ERROR: No query provided"
+  echo "Usage: search.sh \"your search query\""
+  exit 1
+fi
+
+# Escape JSON string: replace backslash, then quotes, then control chars
+# Compatible with sed on Linux, macOS, and Windows (Git Bash/WSL)
+ESCAPED_QUERY=$(printf '%s\n' "$QUERY" | sed 's/\\/\\\\/g; s/"/\\"/g; s/	/\\t/g')
+
+# Call Felo API
+curl -s -X POST https://openapi.felo.ai/v2/chat \
+  -H "Authorization: Bearer $FELO_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d "{\"query\": \"$ESCAPED_QUERY\"}"

package/felo-slides/README.md

@@ -13,11 +13,13 @@ Generate presentation slides with the Felo PPT Task API (asynchronous workflow).
 
 ### 1) Install the skill
 
+**一键安装（推荐）：**
+
 ```bash
-npx @claude/skills add felo-slides
+npx skills add Felo-Inc/felo-skills --skill felo-slides
 ```
 
-Or install manually from this repository:
+**手动安装：** 若上述命令不可用，从本仓库复制到 Claude Code 的 skills 目录：
 
 ```bash
 # Linux/macOS
@@ -27,6 +29,8 @@ cp -r felo-slides ~/.claude/skills/
 Copy-Item -Recurse felo-slides "$env:USERPROFILE\.claude\skills\"
 ```
 
+(Clone the repo first if needed: `git clone https://github.com/Felo-Inc/felo-skills.git`.)
+
 ### 2) Configure API key
 
 Create an API key at [felo.ai](https://felo.ai) -> Settings -> API Keys, then set:

package/felo-superAgent/README.md

@@ -31,8 +31,20 @@
 
 ### 1. 安装
 
+**一键安装（推荐）：**
+
 ```bash
-npx @claude/skills add felo-superAgent
+npx skills add Felo-Inc/felo-skills --skill felo-superAgent
+```
+
+**手动安装：** 若上述命令不可用，从本仓库复制到 Claude Code 的 skills 目录：
+
+```bash
+# Linux/macOS
+cp -r felo-superAgent ~/.claude/skills/
+
+# Windows (PowerShell)
+Copy-Item -Recurse felo-superAgent "$env:USERPROFILE\.claude\skills\"
 ```
 
 （若为本地 skill，确保 Cursor/Claude Code 已配置该 skill 路径。）

package/felo-web-fetch/README.md

@@ -15,11 +15,13 @@ Extract structured webpage content from URLs with the Felo Web Extract API.
 
 ### 1) Install the skill
 
+**一键安装（推荐）：**
+
 ```bash
-npx @claude/skills add felo-web-fetch
+npx skills add Felo-Inc/felo-skills --skill felo-web-fetch
 ```
 
-Or install manually from this repository:
+**手动安装：** 若上述命令不可用，从本仓库复制到 Claude Code 的 skills 目录：
 
 ```bash
 # Linux/macOS
@@ -29,6 +31,8 @@ cp -r felo-web-fetch ~/.claude/skills/
 Copy-Item -Recurse felo-web-fetch "$env:USERPROFILE\.claude\skills\"
 ```
 
+(Clone the repo first if needed: `git clone https://github.com/Felo-Inc/felo-skills.git`.)
+
 ### 2) Configure API key
 
 Create API key at [felo.ai](https://felo.ai) -> Settings -> API Keys, then set:

package/felo-x-search/clawhub.json

@@ -0,0 +1,12 @@
+{
+  "name": "Felo X Search",
+  "tagline": "Search X (Twitter) users, tweets, and replies via Felo API in Claude Code",
+  "description": "Felo X Search lets you look up X (Twitter) user profiles, search users and tweets, fetch user timelines, and get tweet replies directly from Claude Code. Uses the Felo Open API; requires a Felo API key. Supports user lookup, user search, user tweets, tweet search, and tweet replies with readable Markdown or raw JSON output.",
+  "category": "data",
+  "tags": ["twitter", "x", "search", "social", "felo", "api"],
+  "version": "1.0.0",
+  "license": "MIT",
+  "pricing": "free",
+  "support_url": "https://github.com/Felo-Inc/felo-skills/issues",
+  "homepage": "https://github.com/Felo-Inc/felo-skills"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "felo-ai",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "Felo AI CLI - real-time search, PPT generation, web fetch, and YouTube subtitles from the terminal",
   "type": "module",
   "main": "src/cli.js",
@@ -32,6 +32,7 @@
     "felo-search": "^0.1.1"
   },
   "scripts": {
-    "test": "node --test tests/"
+    "test": "node --test tests/",
+    "publish": "npm publish"
   }
-}
+}

package/scripts/openclaw-install.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+# Install felo-skills into OpenClaw's workspace skills directory
+# Usage: ./scripts/openclaw-install.sh [--dry-run]
+
+set -euo pipefail
+
+SKILLS_DIR="${HOME}/.openclaw/workspace/skills"
+REPO_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+DRY_RUN=false
+
+[[ "${1:-}" == "--dry-run" ]] && DRY_RUN=true
+
+# Find all SKILL.md files and install each skill
+installed=0
+skipped=0
+
+while IFS= read -r skill_md; do
+  skill_dir="$(dirname "$skill_md")"
+  skill_name="$(basename "$skill_dir")"
+  target="${SKILLS_DIR}/${skill_name}"
+
+  if [[ -e "$target" ]]; then
+    skipped=$((skipped + 1))
+    continue
+  fi
+
+  if $DRY_RUN; then
+    echo "  [dry-run] would install: $skill_name"
+  else
+    mkdir -p "$SKILLS_DIR"
+    ln -sf "$skill_dir" "$target"
+    echo "  ✅ installed: $skill_name"
+  fi
+  installed=$((installed + 1))
+done < <(find "$REPO_DIR" -name "SKILL.md" -not -path "*/.git/*")
+
+if $DRY_RUN; then
+  echo ""
+  echo "Dry run complete. Would install $installed skill(s). ($skipped already exist)"
+else
+  echo ""
+  echo "Done. Installed $installed skill(s). ($skipped already existed)"
+  echo "Restart OpenClaw (openclaw gateway restart) to pick up new skills."
+fi

package/README.en.md

@@ -1,129 +0,0 @@
-# Felo AI
-
-**Ask anything. Get current answers powered by AI.**
-
-Felo AI provides a terminal CLI and Claude Code skill, with support for English, Chinese (Simplified & Traditional), Japanese, and Korean.
-
-[![License](https://img.shields.io/badge/license-MIT-green)]()
-
----
-
-## Capabilities
-
-Felo AI offers **Real-time Search**, **PPT Generation**, **Web Fetch**, and **YouTube Subtitles**. Use them via the CLI in your terminal, or in Claude Code via skills (search can trigger automatically).
-
-### Capability 1: Real-time Search
-
-Search the web for up-to-date information and get AI-synthesized answers. Ideal for weather, news, prices, documentation, tech updates, and any question that needs “right now” information.
-
-- **Multi-language**: Ask in your preferred language.
-- **Terminal**: `felo search "your question"`
-- **Claude Code**: After installing the skill, it triggers automatically, or type `/felo-ai your question`
-- **Examples**: `felo search "Tokyo weather"`, `felo search "React 19 new features" --verbose`
-
-### Capability 2: Generate PPT (Felo Slides)
-
-Terminal: `felo slides "your topic"`. In Claude Code: install `npx @claude/skills add felo-slides`, then `/felo-slides your topic`. You get an online document link when done. Examples: `felo slides "Felo product intro, 3 slides"`, `felo slides "Introduction to React"`.
-
----
-
-## Install & Configure
-
-### Install CLI
-
-```bash
-npm install -g felo-ai
-```
-
-Run without installing: `npx felo-ai search "Tokyo weather"`  
-After install, the command is `felo`.
-
-### Configure API Key
-
-Recommended (persisted):
-
-```bash
-felo config set FELO_API_KEY your-api-key-here
-```
-
-Or set the environment variable: `export FELO_API_KEY="your-api-key-here"` (Linux/macOS), `$env:FELO_API_KEY="your-api-key-here"` (Windows PowerShell).
-
-Get your API key at [felo.ai](https://felo.ai) (Settings → API Keys).
-
-### Commands
-
-| Command | Description |
-|---------|-------------|
-| `felo search "<query>"` | Real-time search |
-| `felo slides "<prompt>"` | Generate PPT |
-| `felo web-fetch --url <url>` | Fetch webpage content (markdown/text/html) |
-| `felo youtube-subtitling -v <url-or-id>` | Fetch YouTube video subtitles |
-| `felo config set FELO_API_KEY <key>` | Save API key |
-| `felo config get/list/path/unset` | View / list / path / remove config |
-
-### Examples
-
-**Search**
-
-```bash
-felo search "Tokyo weather"
-felo search "MacBook Air M3 price"
-felo search "React 19 new features" --verbose
-npx felo-ai search "Tokyo weather"
-```
-
-**Slides**
-
-```bash
-felo slides "Felo product intro, 3 slides"
-felo slides "Introduction to React"
-felo slides "Q4 2024 business review, 10 pages" --poll-timeout 300
-npx felo-ai slides "Tokyo travel guide, 5 slides"
-```
-
-**Web fetch**
-
-```bash
-felo web-fetch --url "https://example.com"
-felo web-fetch --url "https://example.com" --format text --readability
-node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --format markdown
-```
-
-**YouTube subtitling**
-
-```bash
-felo youtube-subtitling -v "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
-felo youtube-subtitling -v "dQw4w9WgXcQ" --language en
-node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs -v "dQw4w9WgXcQ" -l zh-CN
-```
-
----
-
-## Claude Code Skills
-
-**Search** — Install and use real-time search:
-
-```bash
-npx @claude/skills add felo-search
-```
-
-After setting `FELO_API_KEY`, ask Claude things like “What’s the weather in Tokyo today?” or “React 19 new features”; the search skill triggers automatically (or use `/felo-search your question`).
-
-**Slides (PPT)** — `npx @claude/skills add felo-slides`, then `/felo-slides your topic`. Same `FELO_API_KEY`. [Details →](./felo-slides/README.md)
-
-**Web Fetch** — `felo web-fetch --url "https://example.com"` or run `node felo-web-fetch/scripts/run_web_fetch.mjs` from repo. [Details →](./felo-web-fetch/README.md)
-
-**YouTube Subtitling** — `felo youtube-subtitling -v "URL_or_VIDEO_ID"` or run `node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs` from repo. [Details →](./felo-youtube-subtitling/README.md)
-
----
-
-## Links
-
-- [Felo Open Platform](https://openapi.felo.ai/docs/) — Get your API key
-- [API Documentation](https://openapi.felo.ai/docs/api-reference/v2/chat.html)
-- [More examples](./docs/EXAMPLES.md) | [FAQ](./docs/FAQ.md) | [GitHub Issues](https://github.com/Felo-Inc/felo-skills/issues)
-
----
-
-**Other languages:** [Chinese (Simplified)](README.zh-CN.md) | [Japanese](README.ja.md) | [Korean](README.ko.md) | [Chinese (Traditional)](README.zh-TW.md)
-