felo-ai 0.2.46 → 0.2.48

package/felo-superAgent/README.md

@@ -1,25 +1,28 @@
 # Felo SuperAgent Skill for Claude Code
 
-**AI conversation with real-time streaming output, supporting continuous conversation.**
+**AI conversation with real-time streaming output, supporting continuous multi-turn conversation.**
 
-Use the Felo Open Platform SuperAgent API in Claude Code to initiate conversations with SuperAgent, receive real-time SSE streaming responses, and query conversation details.
+Use the Felo Open Platform SuperAgent API in Claude Code to initiate conversations with SuperAgent, receive real-time SSE streaming responses, and manage conversation state across turns.
 
 ---
 
 ## Features
 
-- **Streaming conversation**: Create a conversation and receive AI responses in real-time via SSE
-- **LiveDoc association**: Each conversation corresponds to a LiveDoc for subsequent resource viewing
-- **Continuous conversation**: Continue asking questions in an existing conversation using `--thread-id`
-- **LiveDoc management**: List LiveDocs and view resources within a specific LiveDoc
-- **Multi-language**: Supports `accept_language` (e.g., zh, en, ja, ko)
-- **Tool invocation**: Supports image generation, research reports, documents, PPT, HTML, Twitter search, and more
+- **Streaming conversation** — create a conversation and receive AI responses in real-time via SSE
+- **LiveDoc association** — each conversation is linked to a LiveDoc for resource tracking
+- **Continuous conversation** — continue asking questions in an existing thread using `--thread-id`
+- **Brand style support** — pass a writing style via `--ext` to guide output (used by `felo-twitter-writer` and other skills)
+- **Style library** — fetch saved brand styles from the API with `run_style_library.mjs`
+- **LiveDoc management** — list LiveDocs and view resources within a specific LiveDoc
+- **Multi-language** — supports `--accept-language` (e.g., zh, en, ja, ko)
+- **Tool invocation** — image generation, research reports, documents, PPT, HTML, Twitter/X search, and more
 
 **Use cases:**
 
 - Need SuperAgent streaming answers
 - Need conversation associated with LiveDoc for traceable resources
 - Multi-turn/continuous conversation (reuse the same LiveDoc)
+- Tweet writing, logo design, or e-commerce product images with brand style guidance
 
 **Not suitable for:**
 
@@ -34,13 +37,13 @@ Use the Felo Open Platform SuperAgent API in Claude Code to initiate conversatio
 
 ### 1. Installation
 
-**One-click install (recommended):**
+**Via ClawHub:**
 
 ```bash
-npx skills add Felo-Inc/felo-skills --skill felo-superAgent
+clawhub install felo-superAgent
 ```
 
-**Manual install:** If the above command is unavailable, copy from this repository to Claude Code's skills directory:
+**Manual install:**
 
 ```bash
 # Linux/macOS
@@ -50,14 +53,10 @@ cp -r felo-superAgent ~/.claude/skills/
 Copy-Item -Recurse felo-superAgent "$env:USERPROFILE\.claude\skills\"
 ```
 
-(If using a local skill, ensure Cursor/Claude Code has configured the skill path.)
-
 ### 2. Configure API Key
 
-Same as other Felo skills, use the same API Key:
-
 1. Open [felo.ai](https://felo.ai) and log in
-2. Avatar → **Settings** → **API Keys** → Create and copy Key
+2. Avatar → **Settings** → **API Keys** → Create and copy key
 3. Set environment variable:
 
 ```bash
@@ -68,375 +67,317 @@ export FELO_API_KEY="your-api-key-here"
 $env:FELO_API_KEY="your-api-key-here"
 ```
 
-For permanent configuration, add to your shell profile (~/.bashrc, ~/.zshrc) or system environment variables.
+For permanent configuration, add to your shell profile (`~/.bashrc`, `~/.zshrc`) or system environment variables.
 
 ### 3. Usage
 
-**Trigger in conversation:**
+**Trigger in Claude Code conversation:**
 
-- Explicit commands: `/felo-superagent`, "use felo super agent"
-- Describe intent: SuperAgent conversation, streaming conversation, LiveDoc conversation, continuous conversation
+```
+/felo-superagent What is the latest news about AI?
+/felo-superagent Tell me more
+```
 
-**Run script directly from command line:**
+**Run script directly:**
 
 ```bash
-node felo-superAgent/scripts/run_superagent.mjs --query "What is the latest news about AI?"
+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>
 ```
 
-Output is the complete answer text after streaming aggregation. Add `--json` to get JSON including `thread_short_id` and `live_doc_short_id`.
-
-**CLI commands (after installation):**
+**CLI commands (after `npm install -g felo-ai`):**
 
 ```bash
-# SuperAgent conversation
 felo superagent "What is the latest news about AI?"
-
-# Continue conversation
 felo superagent "Tell me more" --thread-id <thread_short_id>
-
-# List LiveDocs
 felo livedocs
-felo livedocs --page 2 --size 10
-felo livedocs --keyword AI
-
-# View resources in a specific LiveDoc
 felo livedoc-resources <livedoc-id>
+felo style-library TWITTER --accept-language en
 ```
 
 ---
 
-## Script Parameters
-
-### superagent
-
-| Parameter                         | Description                                                       |
-| --------------------------------- | ----------------------------------------------------------------- |
-| `--query <text>`                  | User question (required, 1-2000 characters)                       |
-| `--thread-id <id>`               | Existing thread ID for follow-up conversations                    |
-| `--live-doc-id <id>`             | Reuse existing LiveDoc short_id (continuous conversation)         |
-| `--skill-id <id>`                | Skill ID (new conversations only)                                 |
-| `--selected-resource-ids <ids>`  | Comma-separated resource IDs (new conversations only)             |
-| `--ext <json>`                   | Extra parameters as JSON, e.g., `'{"style_id":"xxx"}'` (new conversations only) |
-| `--accept-language <lang>`       | Language preference, e.g., zh, en, ja, ko                         |
-| `--timeout <seconds>`            | Request/stream timeout, default 60                                |
-| `--json`                         | Output JSON (includes answer, thread_short_id, live_doc_short_id) |
-| `--verbose`                      | Log stream connection details to stderr                           |
-
-### livedocs
-
-| Parameter                  | Description                     |
-| -------------------------- | ------------------------------- |
-| `-p, --page <number>`     | Page number, default 1          |
-| `-s, --size <number>`     | Items per page, default 20      |
-| `-k, --keyword <text>`    | Keyword filter                  |
-| `-j, --json`              | Output raw JSON                 |
-| `-t, --timeout <seconds>` | Request timeout, default 60     |
-
-### livedoc-resources
-
-| Parameter                  | Description                     |
-| -------------------------- | ------------------------------- |
-| `<livedoc-id>`            | LiveDoc short_id (required)     |
-| `-j, --json`              | Output raw JSON                 |
-| `-t, --timeout <seconds>` | Request timeout, default 60     |
+## Scripts
 
----
+This skill provides two scripts:
 
-## Output Format
+| Script | Description |
+|---|---|
+| `run_superagent.mjs` | Create/continue a conversation and stream the answer |
+| `run_style_library.mjs` | Fetch brand styles from the style library API |
 
-**Default (plain text):**
-Script stdout is the complete answer content (concatenated from SSE `message` events).
+### run_superagent.mjs parameters
 
-**`--json`:**
-Single-line JSON object, for example:
+| Parameter | Description |
+|---|---|
+| `--query <text>` | User question (required, 1–2000 characters) |
+| `--thread-id <id>` | Existing thread ID for follow-up conversations |
+| `--live-doc-id <id>` | Reuse existing LiveDoc short_id |
+| `--skill-id <id>` | Skill ID for new conversations (`twitter-writer`, `logo-and-branding`, `ecommerce-product-image`) |
+| `--selected-resource-ids <ids>` | Comma-separated resource IDs (new conversations only) |
+| `--ext <json>` | Extra parameters as JSON (new conversations only). Used for brand style — see below. |
+| `--accept-language <lang>` | Language preference: `en`, `zh`, `ja`, `ko`, etc. |
+| `--timeout <seconds>` | Request/stream timeout, default 60 |
+| `--json` | Output JSON with `answer`, `thread_short_id`, `live_doc_short_id` |
+| `--verbose` | Log stream connection details to stderr |
 
-```json
-{
-  "status": "ok",
-  "data": {
-    "answer": "Complete answer content...",
-    "thread_short_id": "TvyKouzJirXjFdst4uKRK3",
-    "live_doc_short_id": "PvyKouzJirXjFdst4uKRK3",
-    "live_doc_url": "https://felo.ai/zh-Hans/livedoc/...",
-    "image_urls": [{"url": "...", "title": "..."}],
-    "discoveries": [{"title": "Research Report"}],
-    "documents": [{"title": "Generated Document"}],
-    "ppts": [{"title": "Presentation"}],
-    "htmls": [{"title": "HTML Page"}],
-    "search_x": [{"tweets": [...]}]
-  }
-}
-```
+### run_style_library.mjs parameters
 
-Use `thread_short_id` to call the "query conversation details" API, and `live_doc_short_id` can be passed to `felo-livedoc` to query related resources.
+| Parameter | Description |
+|---|---|
+| `--category <category>` | Style category (required): `TWITTER`, `INSTAGRAM`, `LEMON8`, `NOTECOM`, `WEBSITE`, `IMAGE` |
+| `--accept-language <lang>` | Language for labels/tags (e.g. `en`, `zh-Hans`, `ja`). Default: `en` |
+| `--json` | Output raw JSON |
+| `--timeout <seconds>` | Request timeout, default 60 |
 
 ---
 
-## Complete Examples
+## Brand Style (`--ext`)
 
-### Example 1: Simple question
+When starting a new conversation with a skill ID, you can pass a brand style via `--ext` to guide the output. The style is fetched from the style library and serialized as a JSON string.
+
+### Fetch styles
 
 ```bash
-node felo-superAgent/scripts/run_superagent.mjs \
-  --query "What is quantum computing?" \
-  --accept-language en \
-  --timeout 90
+node felo-superAgent/scripts/run_style_library.mjs --category TWITTER --accept-language en
 ```
 
-**Output:**
+Output (one block per style, blank line between):
+
 ```
-SuperAgent: creating conversation...
-Quantum computing is a revolutionary approach to computation that leverages...
-[complete streaming answer]
+Style name: darioamodei
+Style labels: Thoughtful long-form essays
+Style DNA: # Dario Amodei (@DarioAmodei) Tweet Writing Style DNA
+...（full content）
+
+Style name: My Bold Voice
+Style labels: bold, provocative
+Style DNA: # My Bold Voice Style DNA
+...（full content）
+Cover file ID: file_abc123
 ```
 
-### Example 2: Continue conversation on existing LiveDoc
+Fields per entry:
 
-```bash
-# First conversation
-node felo-superAgent/scripts/run_superagent.mjs \
-  --query "Explain artificial intelligence" \
-  --json
+| Field | Source | Notes |
+|---|---|---|
+| `Style name` | `name` | Always present |
+| `Style labels` | `content.labels[lang]` or `content.tags[lang]` | Language-aware, comma-separated; omitted if absent |
+| `Style DNA` | `content.styleDna` | Full text (TWITTER type); omitted if absent |
+| `Cover file ID` | `coverFileId` | Omitted if null |
 
-# Returns: {"data": {"live_doc_short_id": "PvyKouzJirXjFdst4uKRK3", ...}}
+User-created styles appear before recommended styles.
 
-# Continue on same LiveDoc
-node felo-superAgent/scripts/run_superagent.mjs \
-  --query "What are the main applications?" \
-  --live-doc-id "PvyKouzJirXjFdst4uKRK3"
-```
+### Pass style to SuperAgent
 
-### Example 3: Follow-up question in thread
+Take the full text block for the chosen style and serialize it into `brand_style_requirement`. Pass the value **completely — do NOT truncate `Style DNA`**:
 
 ```bash
-# First question
-node felo-superAgent/scripts/run_superagent.mjs \
-  --query "What is machine learning?" \
-  --json
-
-# Returns: {"data": {"thread_short_id": "TvyKouzJirXjFdst4uKRK3", ...}}
-
-# Follow-up question
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "Can you elaborate on neural networks?" \
-  --thread-id "TvyKouzJirXjFdst4uKRK3"
+  --query "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: # Dario Amodei (@DarioAmodei) Tweet Writing Style DNA\n\n## 风格速写\nDario writes like a serious intellectual...（full content）"}' \
+  --accept-language en
 ```
 
-### Example 4: With verbose logging
+Category mapping for skill IDs:
 
-```bash
-node felo-superAgent/scripts/run_superagent.mjs \
-  --query "Latest developments in AI" \
-  --accept-language en \
-  --verbose \
-  --json
-```
+| Skill ID | Style category |
+|---|---|
+| `twitter-writer` | `TWITTER` |
+| `logo-and-branding` | `IMAGE` |
+| `ecommerce-product-image` | `IMAGE` |
 
-**Stderr output:**
-```
-SuperAgent: creating conversation...
-Stream key: abc123...
-Thread ID: TvyKouzJirXjFdst4uKRK3
-LiveDoc ID: PvyKouzJirXjFdst4uKRK3
-[stream] event=message
-[stream] data={"content":"Recent AI developments..."}
-```
+`--ext` is only valid for new conversations. Never pass it in follow-up mode (`--thread-id`).
 
 ---
 
-## Tool Support
+## Using with Claude Code
 
-SuperAgent may invoke tools during conversation. The script automatically extracts and displays:
+### Installation
 
-### Image Generation
-- Tool: `generate_images`
-- Output: Image URLs and titles
-- Example: `[AI Generated Image](https://felo.ai/zh-Hans/livedoc/...)`
-
-### Research & Discovery
-- Tool: `generate_discovery`
-- Output: Research report titles
-- Example: `[AI Research Report](https://felo.ai/zh-Hans/livedoc/...)`
-
-### Document Generation
-- Tool: `generate_document`
-- Output: Document titles
-- Example: `[Generated Document](https://felo.ai/zh-Hans/livedoc/...)`
-
-### Presentation Generation
-- Tool: `generate_ppt`
-- Output: PPT titles
-- Example: `[AI Presentation](https://felo.ai/zh-Hans/livedoc/...)`
-
-### HTML Generation
-- Tool: `generate_html`
-- Output: HTML page titles
-- Example: `[HTML Page](https://felo.ai/zh-Hans/livedoc/...)`
-
-### Twitter/X Search
-- Tool: `search_x`
-- Output: Tweet content, author info, metrics (likes, retweets, views)
-- Example:
-  ```
-  [Twitter Search Results] (5 tweets)
-    Elon Musk (@elonmusk) [1.2K likes | 234 retweets | 45K views]
-    AI is the future of humanity...
-    https://twitter.com/...
-  ```
+```bash
+# Via ClawHub
+clawhub install felo-superAgent
 
----
+# Manual
+cp -r felo-superAgent ~/.claude/skills/
+```
 
-## Error Handling
+### Triggering the skill
 
-Common error codes (see [SuperAgent API documentation](https://openapi.felo.ai/docs/api-reference/v2/superagent.html)):
+Claude Code automatically triggers this skill for SuperAgent conversations. Explicit commands:
 
-- `INVALID_API_KEY` (401): Key is invalid or revoked
-- `SUPER_AGENT_CONVERSATION_CREATE_FAILED` (502): Failed to create conversation
-- Other 502 errors: Downstream service issues, retry or contact support
+```
+/felo-superagent What is the latest news about AI?
+/felo-superagent Write a tweet about AI trends
+/felo-superagent Create a logo for my coffee shop
+```
 
-If `FELO_API_KEY` is not configured, the script will error and show configuration instructions.
+### What Claude manages automatically
 
----
+- **LiveDoc reuse** — reuses the same LiveDoc across the session; only fetches the list when no ID is available
+- **Thread continuity** — passes `--thread-id` for all follow-up messages; only starts a new thread when the user explicitly requests it or a different skill ID is needed
+- **Style selection** — for skill-based new conversations (`twitter-writer`, `logo-and-branding`, `ecommerce-product-image`), fetches the matching style library, presents options to the user, and passes the chosen style via `--ext`
+- **State extraction** — after every call, extracts `thread_short_id` and `live_doc_short_id` from the stderr `[state]` line for use in the next call
 
-## API Workflow
+### Example conversation
 
-The script handles this workflow automatically:
+```
+You:    Write a tweet about AI trends
 
-1. **Create conversation:**
-   - New: `POST /v2/conversations`
-   - Follow-up: `POST /v2/conversations/{threadId}/follow_up`
-   - Returns: `stream_key`, `thread_short_id`, `live_doc_short_id`
+Claude: Here are the available Twitter writing styles — choosing one will make
+        the output more accurate:
 
-2. **Consume SSE stream:**
-   - `GET /v2/conversations/stream/{stream_key}`
-   - Supports offset parameter for resuming: `?offset={lastOffset}`
-   - Reconnects automatically if connection drops (2-second delay)
+        [Your styles]
+        1. My Bold Voice
 
-3. **Parse events:**
-   - `message` — Direct text content
-   - `stream` — Wrapped content with type information
-   - `heartbeat` — Keep-alive signal
-   - `done` / `completed` / `complete` — Stream finished
-   - `error` — Error event (non-terminal, continues reading)
+        [Recommended styles]
+        2. darioamodei
 
-4. **Extract tool results:**
-   - Automatically detects and formats tool outputs
-   - Deduplicates results to avoid showing the same resource multiple times
+        0. No preference — use default style
 
-Base URL: `https://openapi.felo.ai` (override with `FELO_API_BASE` if needed).
+You:    2
 
----
+Claude: [streams the tweet in darioamodei style in real time]
 
-## Conversation Continuity
+You:    Make it shorter
 
-**Three modes of conversation:**
+Claude: [follow-up — no style re-selection, streams updated tweet]
+```
 
-1. **New conversation:** No IDs provided — creates fresh thread and LiveDoc
-2. **LiveDoc continuation:** Provide `--live-doc-id` — new thread, same knowledge base
-3. **Thread follow-up:** Provide `--thread-id` — continue exact conversation
+---
 
-**When to use each mode:**
-- Use **new conversation** for unrelated questions
-- Use **LiveDoc continuation** to build knowledge on a topic across multiple threads
-- Use **thread follow-up** for clarifying questions or continuing the exact same discussion
+## Output Format
 
----
+**Default (streaming plain text):**
+Answer streams directly to stdout in real time. Do not summarize or re-output it.
 
-## Troubleshooting
+**`--json` (suppresses streaming):**
 
-### API Key Not Set
+```json
+{
+  "status": "ok",
+  "data": {
+    "answer": "Complete answer content...",
+    "thread_short_id": "TvyKouzJirXjFdst4uKRK3",
+    "live_doc_short_id": "PvyKouzJirXjFdst4uKRK3",
+    "live_doc_url": "https://felo.ai/livedoc/...",
+    "image_urls": [{"url": "...", "title": "..."}],
+    "discoveries": [{"title": "Research Report"}],
+    "documents": [{"title": "Generated Document"}],
+    "ppts": [{"title": "Presentation"}],
+    "htmls": [{"title": "HTML Page"}],
+    "search_x": [{"tweets": [...]}]
+  }
+}
+```
+
+**State line (stderr):**
 
-**Error:**
 ```
-ERROR: FELO_API_KEY not set
+[state] thread_short_id=TvyKouzJirXjFdst4uKRK3 live_doc_short_id=PvyKouzJirXjFdst4uKRK3 live_doc_url=https://felo.ai/livedoc/...
 ```
 
-**Solution:**
-1. Get your API key from https://felo.ai (Settings → API Keys)
-2. Set the environment variable:
-   ```bash
-   export FELO_API_KEY="your-api-key-here"
-   ```
-3. Restart your terminal or reload the environment
+Always extract `thread_short_id` and `live_doc_short_id` from this line for use in the next call.
 
-### Invalid API Key
+---
 
-**Error:**
-```
-HTTP 401: INVALID_API_KEY
+## Complete Examples
+
+### Example 1: Simple question
+
+```bash
+node felo-superAgent/scripts/run_superagent.mjs \
+  --query "What is quantum computing?" \
+  --accept-language en
 ```
 
-**Solution:**
-- Check if your API key is correct
-- Verify the key hasn't been revoked at https://felo.ai
-- Generate a new key if needed
+### Example 2: Follow-up in thread
 
-### Stream Timeout
+```bash
+# First question — capture thread_short_id from stderr [state]
+node felo-superAgent/scripts/run_superagent.mjs \
+  --query "What is machine learning?" \
+  --live-doc-id "PvyKouzJirXjFdst4uKRK3"
 
-**Error:**
-```
-Stream idle timeout (no data for 7200s)
+# Follow-up
+node felo-superAgent/scripts/run_superagent.mjs \
+  --query "Can you elaborate on neural networks?" \
+  --thread-id "TvyKouzJirXjFdst4uKRK3" \
+  --live-doc-id "PvyKouzJirXjFdst4uKRK3"
 ```
 
-**Solution:**
-- The stream was idle for 2 hours with no data
-- This is normal for very long-running conversations
-- Retry the query or increase timeout with `--timeout 120`
-
-### Connection Issues
+### Example 3: Tweet writing with brand style
 
-**Behavior:** Script shows "SuperAgent: creating conversation..." but hangs
+```bash
+# Fetch styles
+node felo-superAgent/scripts/run_style_library.mjs --category TWITTER --accept-language en
 
-**Solution:**
-- Check your internet connection
-- Verify `https://openapi.felo.ai` is accessible
-- Try with `--verbose` to see detailed connection logs
-- Check if a firewall is blocking SSE connections
+# New conversation with chosen style
+node felo-superAgent/scripts/run_superagent.mjs \
+  --query "Write a tweet about AI trends" \
+  --live-doc-id "PvyKouzJirXjFdst4uKRK3" \
+  --skill-id twitter-writer \
+  --ext '{"brand_style_requirement":"Style name: darioamodei\nStyle labels: Thoughtful long-form essays\nStyle DNA: ...（full content）"}' \
+  --accept-language en
+```
 
-### Tool Results Not Showing
+### Example 4: Logo design with brand style
 
-**Behavior:** Answer appears but tool results (images, documents) are missing
+```bash
+# Fetch IMAGE styles
+node felo-superAgent/scripts/run_style_library.mjs --category IMAGE --accept-language en
 
-**Solution:**
-- Tool results appear inline during streaming
-- Use `--json` to see all tool results in structured format
-- Check if LiveDoc URL is accessible
+# New conversation with chosen style
+node felo-superAgent/scripts/run_superagent.mjs \
+  --query "Design a logo for my coffee shop called Bean & Brew" \
+  --live-doc-id "PvyKouzJirXjFdst4uKRK3" \
+  --skill-id logo-and-branding \
+  --ext '{"brand_style_requirement":"Style name: Minimalist Modern\nStyle labels: clean, monochrome\nStyle DNA: ...（full content）\nCover file ID: file_333"}' \
+  --accept-language en
+```
 
 ---
 
-## Advanced Usage
+## Tool Support
 
-### Custom API Base URL
+SuperAgent may invoke tools during conversation. The script automatically extracts and displays:
 
-Override the API base URL:
+| Tool | Output |
+|---|---|
+| `generate_images` | Image URLs and titles |
+| `generate_discovery` | Research report titles |
+| `generate_document` | Document titles |
+| `generate_ppt` | PPT titles |
+| `generate_html` | HTML page titles |
+| `search_x` | Tweet content, author info, metrics |
 
-```bash
-export FELO_API_BASE="https://custom-api.example.com"
-node felo-superAgent/scripts/run_superagent.mjs --query "test"
-```
+---
 
-### Custom Web Base URL
+## Error Handling
 
-Override the web base URL for LiveDoc links:
+| Error | Cause | Solution |
+|---|---|---|
+| `FELO_API_KEY not set` | Missing API key | Set `FELO_API_KEY` env var |
+| `HTTP 401: INVALID_API_KEY` | Invalid or revoked key | Generate a new key at felo.ai |
+| `SUPER_AGENT_CONVERSATION_CREATE_FAILED` (502) | Upstream error | Retry; contact support if persistent |
+| Stream idle timeout | No data for 2 hours | Retry the query |
+| Connection hangs | Firewall blocking SSE | Try `--verbose`; check proxy settings |
 
-```bash
-export FELO_WEB_BASE="https://custom-web.example.com"
-node felo-superAgent/scripts/run_superagent.mjs --query "test"
-```
+---
 
-### Extended Parameters
+## Advanced Usage
 
-Pass custom parameters to the API:
+### Custom API base URL
 
 ```bash
-node felo-superAgent/scripts/run_superagent.mjs \
-  --query "Generate a report" \
-  --ext '{"style_id":"professional","format":"detailed"}'
+export FELO_API_BASE="https://custom-api.example.com"
+node felo-superAgent/scripts/run_superagent.mjs --query "test"
 ```
 
-### Resource Selection
-
-Select specific resources for the conversation:
+### Resource selection
 
 ```bash
 node felo-superAgent/scripts/run_superagent.mjs \
@@ -449,7 +390,9 @@ node felo-superAgent/scripts/run_superagent.mjs \
 
 ## References
 
+- [SKILL.md](SKILL.md) — full agent instructions, decision logic, and style library format
 - [SuperAgent API Documentation](https://openapi.felo.ai/docs/api-reference/v2/superagent.html)
 - [Felo Open Platform](https://openapi.felo.ai/docs/)
 - [Get API Key](https://felo.ai) (Settings → API Keys)
 - [GitHub Repository](https://github.com/Felo-Inc/felo-skills)
+