felo-ai 0.2.47 → 0.2.48

package/README.md

@@ -15,7 +15,7 @@
   <a href="./felo-search/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
 </p>
 
-**Felo AI CLI** — Real-time search, PPT generation, web fetch, YouTube subtitles, and X (Twitter) search from the terminal. Also works as Claude Code skills. Supports Chinese, English, Japanese, and Korean.
+**Felo AI CLI** — Real-time search, PPT generation, web fetch, YouTube subtitles, X (Twitter) search, SuperAgent conversation, and Twitter writing from the terminal. Also works as Claude Code skills. Supports Chinese, English, Japanese, and Korean.
 
 <p align="center">
   <a href="https://felo.ai">Felo AI</a> · <a href="https://openapi.felo.ai/docs/">Docs</a> · <a href="https://openapi.felo.ai/docs/api-reference/v2/chat.html">API Reference</a> · <a href="./docs/EXAMPLES.md">Examples</a> · <a href="./docs/FAQ.md">FAQ</a> · <a href="https://clawhub.ai/u/wangzhiming1999">ClawHub</a> · <a href="https://discord.gg/9W8NubHA">Discord</a> · <a href="https://x.com/felo_ai">X (Twitter)</a>
@@ -55,6 +55,8 @@ $env:FELO_API_KEY="..."             # Windows (PowerShell)
 | `felo x "<query>"`                       | Search X (Twitter) tweets, users, and replies         |
 | `felo livedoc <subcommand>`              | Manage LiveDocs (knowledge bases) and resources       |
 | `felo apple-buy-advisor "<query>"`       | Research and compare Apple products before you buy    |
+| `felo superagent "<query>"`              | AI conversation with real-time streaming output       |
+| `felo style-library <category>`          | List brand styles from the style library              |
 | `felo config <set\|get\|list\|path>`     | Manage API key and config                             |
 
 ---
@@ -127,13 +129,26 @@ felo apple-buy-advisor "Is it worth upgrading to iPad Air 13?"
 /apple-buy-advisor Is it worth upgrading to iPad Air 13?
 ```
 
-**Twitter Writer** — [full options →](./felo-twitter-writer/SKILL.md)
+**Twitter Writer** — [full options →](./felo-twitter-writer/README.md)
 
 ```bash
-# Use as Claude Code skill
+# Use as Claude Code skill — Claude automatically fetches your style library
+# and asks you to pick a writing style before generating
 /felo-twitter-writer Analyze @paulg's tweet style and extract a style DNA
-/felo-twitter-writer Write 3 tweets about AI trends in @paulg's style
+/felo-twitter-writer Write 3 tweets about AI trends
 /felo-twitter-writer Write a Twitter thread about why most startups fail
+/felo-twitter-writer Write a tweet about AI in the style of @darioamodei
+```
+
+```bash
+# Run scripts directly
+node felo-superAgent/scripts/run_style_library.mjs --category TWITTER --accept-language en
+node felo-superAgent/scripts/run_superagent.mjs \
+  --query "/twitter-writer Write a tweet about AI trends" \
+  --live-doc-id "LIVE_DOC_ID" \
+  --skill-id twitter-writer \
+  --ext '{"brand_style_requirement":"Style name: darioamodei\nStyle labels: Thoughtful long-form essays\nStyle DNA: ..."}' \
+  --accept-language en
 ```
 
 **SuperAgent** — [full options →](./felo-superAgent/README.md)
@@ -141,13 +156,22 @@ felo apple-buy-advisor "Is it worth upgrading to iPad Air 13?"
 ```bash
 # Use as Claude Code skill
 /felo-superagent What is the latest news about AI?
-/felo-superagent Tell me more --thread-id <thread_short_id>
+/felo-superagent Write a tweet about quantum computing
+/felo-superagent Design a logo for my coffee shop
 ```
 
 ```bash
 # Run script directly
-node felo-superAgent/scripts/run_superagent.mjs --query "What is quantum computing?"
-node felo-superAgent/scripts/run_superagent.mjs --query "Tell me more" --thread-id <thread_short_id>
+node felo-superAgent/scripts/run_superagent.mjs --query "What is quantum computing?" --live-doc-id "LIVE_DOC_ID"
+node felo-superAgent/scripts/run_superagent.mjs --query "Tell me more" --thread-id <thread_short_id> --live-doc-id "LIVE_DOC_ID"
+```
+
+```bash
+# CLI commands
+felo superagent "What is the latest news about AI?"
+felo superagent "Tell me more" --thread-id <thread_short_id>
+felo style-library TWITTER --accept-language en
+felo style-library IMAGE --accept-language zh-Hans
 ```
 
 **[See 40+ more examples →](./docs/EXAMPLES.md)**
@@ -158,45 +182,118 @@ node felo-superAgent/scripts/run_superagent.mjs --query "Tell me more" --thread-
 
 9 skills across search, content generation, web scraping, social media, knowledge base, shopping advice, Twitter writing, and AI conversation:
 
-| Skill                       | Description                                                   | Docs                                      |
-| --------------------------- | ------------------------------------------------------------- | ----------------------------------------- |
-| **felo-search**             | Real-time web search with AI answers. Triggers automatically. | [→](./felo-search/)                       |
-| **felo-slides**             | Generate PPT from a prompt                                    | [→](./felo-slides/)                       |
-| **felo-web-fetch**          | Fetch and extract webpage content                             | [→](./felo-web-fetch/)                    |
-| **felo-youtube-subtitling** | Fetch YouTube video subtitles                                 | [→](./felo-youtube-subtitling/)           |
-| **felo-x-search**           | Search X (Twitter) tweets, users, replies                     | [→](./felo-x-search/SKILL.md)             |
-| **felo-livedoc**            | Manage knowledge bases and semantic retrieval                 | [→](./felo-livedoc/)                      |
-| **apple-buy-advisor**       | Research and compare Apple products before you buy            | [→](./apple-buy-advisor/)                 |
-| **felo-twitter-writer**     | Analyze tweet style DNA and compose tweets, threads, X posts  | [→](./felo-twitter-writer/SKILL.md)       |
-| **felo-superAgent**         | AI conversation with real-time streaming, continuous threads  | [→](./felo-superAgent/README.md)          |
+| Skill | Description | Docs |
+|---|---|---|
+| **felo-search** | Real-time web search with AI answers. Triggers automatically. | [→](./felo-search/) |
+| **felo-slides** | Generate PPT from a prompt | [→](./felo-slides/) |
+| **felo-web-fetch** | Fetch and extract webpage content | [→](./felo-web-fetch/) |
+| **felo-youtube-subtitling** | Fetch YouTube video subtitles | [→](./felo-youtube-subtitling/) |
+| **felo-x-search** | Search X (Twitter) tweets, users, replies | [→](./felo-x-search/SKILL.md) |
+| **felo-livedoc** | Manage knowledge bases and semantic retrieval | [→](./felo-livedoc/) |
+| **apple-buy-advisor** | Research and compare Apple products before you buy | [→](./apple-buy-advisor/) |
+| **felo-twitter-writer** | Analyze tweet style DNA; compose tweets, threads, X posts with brand style | [→](./felo-twitter-writer/README.md) |
+| **felo-superAgent** | AI conversation with real-time streaming, brand style support, continuous threads | [→](./felo-superAgent/README.md) |
 
 ---
 
-## Skills Install
+## Using felo-twitter-writer and felo-superAgent with Claude Code
 
-### Claude Code (Recommended)
+These two skills work together and share the style library. Here is how Claude uses them.
+
+### Installation
 
 ```bash
-# Add the marketplace
-/plugin marketplace add Felo-Inc/felo-skills
-
-# Install individual skills
-/plugin install felo-search@felo-ai
-/plugin install felo-slides@felo-ai
-/plugin install felo-web-fetch@felo-ai
-/plugin install felo-youtube-subtitling@felo-ai
-/plugin install felo-x-search@felo-ai
-/plugin install felo-livedoc@felo-ai
-/plugin install apple-buy-advisor@felo-ai
-/plugin install felo-twitter-writer@felo-ai
-/plugin install felo-superAgent@felo-ai
+# Via ClawHub
+clawhub install felo-superAgent
+clawhub install felo-twitter-writer
+clawhub install felo-x-search
+clawhub install felo-livedoc
+
+# Manual
+cp -r felo-superAgent ~/.claude/skills/
+cp -r felo-twitter-writer ~/.claude/skills/
+cp -r felo-x-search ~/.claude/skills/
+cp -r felo-livedoc ~/.claude/skills/
+```
+
+### felo-twitter-writer
+
+Trigger keywords: `write a tweet`, `twitter thread`, `style DNA`, `imitate tweet style`, `tweet in the style of`, `X account analysis`, `ghostwrite tweets`
+
+```
+/felo-twitter-writer Analyze @paulg's tweet style
+/felo-twitter-writer Write 3 tweets about AI trends
+/felo-twitter-writer Write a Twitter thread about why most startups fail
+```
+
+**What Claude does automatically for tweet writing (Mode 2, new conversation):**
+
+1. Calls `run_style_library.mjs --category TWITTER` to fetch your saved writing styles
+2. Presents the list grouped as **[Your styles]** / **[Recommended styles]** with a "No preference" option
+3. Waits for your selection, then calls SuperAgent with the full style block in `--ext`
+4. Streams the result in real time — follow-ups reuse the thread without re-fetching styles
+
+```
+You:    Write a Twitter thread about why most startups fail
+
+Claude: Here are the available Twitter writing styles — choosing one will make
+        the output more accurate:
+
+        [Your styles]
+        1. My Bold Voice
+
+        [Recommended styles]
+        2. darioamodei
+
+        0. No preference — use default style
+
+You:    1
+
+Claude: [streams the thread in "My Bold Voice" style]
+
+You:    Make the hook tweet more provocative
+
+Claude: [follow-up — no style re-selection needed]
+```
+
+If the style library is empty, Claude skips the selection step silently.
+
+### felo-superAgent
+
+Trigger keywords: `superagent`, `super agent`, `stream chat`, `streaming conversation`, `write a tweet`, `create a logo`, `product image`
+
+```
+/felo-superagent What is the latest news about AI?
+/felo-superagent Write a tweet about quantum computing
+/felo-superagent Design a logo for my coffee shop
+/felo-superagent Generate a product image for wireless headphones
 ```
 
-### ClawHub
+**What Claude does automatically for skill-based conversations:**
 
-[ClawHub](https://clawhub.ai) is a public skill registry for AI coding agents. Browse all Felo skills on [ClawHub](https://clawhub.ai/u/wangzhiming1999).
+| Skill intent | Style category fetched | `--skill-id` passed |
+|---|---|---|
+| Write tweets | `TWITTER` | `twitter-writer` |
+| Logo / branding | `IMAGE` | `logo-and-branding` |
+| Product images | `IMAGE` | `ecommerce-product-image` |
+| General conversation | — | — |
+
+For skill-based new conversations, Claude fetches the matching style library, presents options, and passes the chosen style via `--ext '{"brand_style_requirement":"..."}'`. The style block includes `Style name`, `Style labels`, `Style DNA`, and optionally `Cover file ID` — passed completely, never truncated.
+
+**Thread and LiveDoc management:**
+- Claude reuses the same LiveDoc across the entire session
+- Every message after the first is a follow-up (`--thread-id`) by default
+- A new thread is only started when you say "new topic", "start over", or when a different skill ID is needed
+- `--ext` is only passed for new conversations, never for follow-ups
+
+---
+
+## Skills Install
+
+### Claude Code
 
 ```bash
+# Via ClawHub (recommended)
 clawhub install felo-search
 clawhub install felo-slides
 clawhub install felo-web-fetch
@@ -204,8 +301,23 @@ clawhub install felo-youtube-subtitling
 clawhub install felo-x-search
 clawhub install felo-livedoc
 clawhub install apple-buy-advisor
-clawhub install felo-twitter-writer
 clawhub install felo-superAgent
+# felo-twitter-writer: no clawhub.json yet — use manual install below
+```
+
+```bash
+# Manual
+git clone https://github.com/Felo-Inc/felo-skills.git
+cd felo-skills
+cp -r felo-search ~/.claude/skills/
+cp -r felo-slides ~/.claude/skills/
+cp -r felo-web-fetch ~/.claude/skills/
+cp -r felo-youtube-subtitling ~/.claude/skills/
+cp -r felo-x-search ~/.claude/skills/
+cp -r felo-livedoc ~/.claude/skills/
+cp -r apple-buy-advisor ~/.claude/skills/
+cp -r felo-twitter-writer ~/.claude/skills/
+cp -r felo-superAgent ~/.claude/skills/
 ```
 
 ### Gemini CLI
@@ -213,40 +325,40 @@ clawhub install felo-superAgent
 ```bash
 git clone https://github.com/Felo-Inc/felo-skills.git
 cd felo-skills
-
-# Copy skill folders to Gemini CLI skills directory
 cp -r felo-search ~/.gemini/skills/
 cp -r felo-slides ~/.gemini/skills/
+cp -r felo-web-fetch ~/.gemini/skills/
+cp -r felo-youtube-subtitling ~/.gemini/skills/
+cp -r felo-x-search ~/.gemini/skills/
+cp -r felo-livedoc ~/.gemini/skills/
 cp -r apple-buy-advisor ~/.gemini/skills/
+cp -r felo-twitter-writer ~/.gemini/skills/
+cp -r felo-superAgent ~/.gemini/skills/
 ```
 
 ### OpenAI Codex
 
 ```bash
 git clone https://github.com/Felo-Inc/felo-skills.git
-# Copy any skill folder to ~/.codex/skills/
+cd felo-skills
 cp -r felo-search ~/.codex/skills/
+cp -r felo-slides ~/.codex/skills/
+cp -r felo-web-fetch ~/.codex/skills/
+cp -r felo-youtube-subtitling ~/.codex/skills/
+cp -r felo-x-search ~/.codex/skills/
+cp -r felo-livedoc ~/.codex/skills/
 cp -r apple-buy-advisor ~/.codex/skills/
+cp -r felo-twitter-writer ~/.codex/skills/
+cp -r felo-superAgent ~/.codex/skills/
 ```
 
 ### OpenClaw
 
 ```bash
+# Installs all skills that contain a SKILL.md (includes felo-twitter-writer and felo-superAgent)
 bash <(curl -s https://raw.githubusercontent.com/Felo-Inc/felo-skills/main/scripts/openclaw-install.sh)
 ```
 
-### Manual Installation
-
-```bash
-git clone https://github.com/Felo-Inc/felo-skills.git
-# Copy any skill folder to the skills directory of your AI coding agent
-# Claude Code: ~/.claude/skills/
-# Gemini CLI:  ~/.gemini/skills/
-# Codex:       ~/.codex/skills/
-cp -r felo-search ~/.claude/skills/
-cp -r apple-buy-advisor ~/.claude/skills/
-```
-
 ---
 
 ## FAQ