felo-ai 0.2.6 → 0.2.9

package/felo-slides/README.md

@@ -1,87 +1,87 @@
-# Felo Slides Skill for Claude Code
-
-Generate presentation slides with the Felo PPT Task API (asynchronous workflow).
-
-## Features
-
-- Generate a PPT deck from a single prompt
-- Poll task status automatically until completion/failure/timeout
-- Return `ppt_url` immediately when the task is completed (fallback to `live_doc_url`)
-- Return `task_id` for follow-up tracking
-
-## Quick Start
-
-### 1) Install the skill
-
-```bash
-npx @claude/skills add felo-slides
-```
-
-Or install manually from this repository:
-
-```bash
-# Linux/macOS
-cp -r felo-slides ~/.claude/skills/
-
-# Windows (PowerShell)
-Copy-Item -Recurse felo-slides "$env:USERPROFILE\.claude\skills\"
-```
-
-### 2) Configure API key
-
-Create an API key at [felo.ai](https://felo.ai) -> Settings -> API Keys, then set:
-
-```bash
-# Linux/macOS
-export FELO_API_KEY="your-api-key-here"
-```
-
-```powershell
-# Windows PowerShell
-$env:FELO_API_KEY="your-api-key-here"
-```
-
-### 3) Trigger the skill
-
-- Intent trigger: "Create a 10-slide product pitch deck"
-- Explicit trigger: `/felo-slides your topic`
-
-## API Workflow
-
-Based on Felo v2 PPT Task API:
-
-1. Create task: `POST /v2/ppts`
-2. Query status (optional): `GET /v2/tasks/{task_id}/status`
-3. Query historical/result: `GET /v2/tasks/{task_id}/historical`
-
-The skill polls every 10 seconds (max wait 1800 seconds). It stops immediately on `COMPLETED`/`SUCCESS` and returns `ppt_url` (fallback `live_doc_url`).
-
-Internal script example:
-
-```bash
-node felo-slides/scripts/run_ppt_task.mjs --query "Felo product intro, 3 slides" --interval 10 --max-wait 1800
-```
-
-## Troubleshooting
-
-### `FELO_API_KEY` is missing
-
-Set the environment variable and restart the Claude Code session.
-
-### `INVALID_API_KEY`
-
-The key is invalid or revoked. Generate a new key from [felo.ai](https://felo.ai).
-
-### Task keeps running for too long
-
-The task may still be processing. Retry later with the same context, or run the script with `--verbose`.
-
-### Task completed but no `ppt_url` / `live_doc_url`
-
-Use the returned `task_id` to query historical endpoint again.
-
-## Links
-
-- [PPT Task API](https://openapi.felo.ai/docs/api-reference/v2/ppt-tasks.html)
-- [Felo Open Platform](https://openapi.felo.ai/docs/)
-- [Get API Key](https://felo.ai)
+# Felo Slides Skill for Claude Code
+
+Generate presentation slides with the Felo PPT Task API (asynchronous workflow).
+
+## Features
+
+- Generate a PPT deck from a single prompt
+- Poll task status automatically until completion/failure/timeout
+- Return `ppt_url` immediately when the task is completed (fallback to `live_doc_url`)
+- Return `task_id` for follow-up tracking
+
+## Quick Start
+
+### 1) Install the skill
+
+```bash
+npx @claude/skills add felo-slides
+```
+
+Or install manually from this repository:
+
+```bash
+# Linux/macOS
+cp -r felo-slides ~/.claude/skills/
+
+# Windows (PowerShell)
+Copy-Item -Recurse felo-slides "$env:USERPROFILE\.claude\skills\"
+```
+
+### 2) Configure API key
+
+Create an API key at [felo.ai](https://felo.ai) -> Settings -> API Keys, then set:
+
+```bash
+# Linux/macOS
+export FELO_API_KEY="your-api-key-here"
+```
+
+```powershell
+# Windows PowerShell
+$env:FELO_API_KEY="your-api-key-here"
+```
+
+### 3) Trigger the skill
+
+- Intent trigger: "Create a 10-slide product pitch deck"
+- Explicit trigger: `/felo-slides your topic`
+
+## API Workflow
+
+Based on Felo v2 PPT Task API:
+
+1. Create task: `POST /v2/ppts`
+2. Query status (optional): `GET /v2/tasks/{task_id}/status`
+3. Query historical/result: `GET /v2/tasks/{task_id}/historical`
+
+The skill polls every 10 seconds (max wait 1800 seconds). It stops immediately on `COMPLETED`/`SUCCESS` and returns `ppt_url` (fallback `live_doc_url`).
+
+Internal script example:
+
+```bash
+node felo-slides/scripts/run_ppt_task.mjs --query "Felo product intro, 3 slides" --interval 10 --max-wait 1800
+```
+
+## Troubleshooting
+
+### `FELO_API_KEY` is missing
+
+Set the environment variable and restart the Claude Code session.
+
+### `INVALID_API_KEY`
+
+The key is invalid or revoked. Generate a new key from [felo.ai](https://felo.ai).
+
+### Task keeps running for too long
+
+The task may still be processing. Retry later with the same context, or run the script with `--verbose`.
+
+### Task completed but no `ppt_url` / `live_doc_url`
+
+Use the returned `task_id` to query historical endpoint again.
+
+## Links
+
+- [PPT Task API](https://openapi.felo.ai/docs/api-reference/v2/ppt-tasks.html)
+- [Felo Open Platform](https://openapi.felo.ai/docs/)
+- [Get API Key](https://felo.ai)

package/felo-slides/SKILL.md

@@ -1,166 +1,166 @@
----
-name: felo-slides
-description: "Generate PPT/slides with Felo PPT Task API in Claude Code. Use when users ask to create/make/generate/export presentations or slide decks, or when explicit commands like /felo-slides are used. Handles API key check, task creation, polling, and final ppt_url output."
----
-
-# Felo Slides Skill
-
-## When to Use
-
-Trigger this skill for requests about creating presentation files:
-
-- Create/generate slides from a topic or outline
-- Turn notes into a PPT deck
-- Build a presentation with a page count requirement
-- Export presentation content into a shareable slide link
-
-Trigger keywords:
-
-- Chinese prompts about making slides or presentations
-- English: slides, PPT, presentation deck, generate presentation
-- Explicit commands: `/felo-slides`, "use felo slides"
-
-Do NOT use this skill for:
-
-- Real-time information lookup (use `felo-search`)
-- Questions about local codebase files
-- Pure text tasks that do not require slide generation
-
-## Setup
-
-### 1. Get API key
-
-1. Visit [felo.ai](https://felo.ai)
-2. Open Settings -> API Keys
-3. Create and copy your API key
-
-### 2. Configure environment variable
-
-Linux/macOS:
-
-```bash
-export FELO_API_KEY="your-api-key-here"
-```
-
-Windows PowerShell:
-
-```powershell
-$env:FELO_API_KEY="your-api-key-here"
-```
-
-## How to Execute
-
-Use Bash tool commands and follow this workflow exactly.
-
-### Step 1: Precheck API key
-
-```bash
-if [ -z "$FELO_API_KEY" ]; then
-  echo "ERROR: FELO_API_KEY not set"
-  exit 1
-fi
-```
-
-If key is missing, stop and return setup instructions.
-
-### Step 2: Run Node Script (create + poll)
-
-Use the bundled script (no `jq` dependency):
-
-```bash
-node felo-slides/scripts/run_ppt_task.mjs \
-  --query "USER_PROMPT_HERE" \
-  --interval 10 \
-  --max-wait 1800 \
-  --timeout 60
-```
-
-Script behavior:
-
-- Creates task via `POST https://openapi.felo.ai/v2/ppts`
-- Polls via `GET https://openapi.felo.ai/v2/tasks/{task_id}/historical`
-- Treats `COMPLETED`/`SUCCESS` as success terminal (case-insensitive)
-- Treats `FAILED`/`ERROR` as failure terminal
-- Stops polling immediately on terminal status
-- Prints `ppt_url` on success (fallback: `live_doc_url`)
-
-Optional debug output:
-
-```bash
-node felo-slides/scripts/run_ppt_task.mjs \
-  --query "USER_PROMPT_HERE" \
-  --interval 10 \
-  --max-wait 1800 \
-  --json \
-  --verbose
-```
-
-This outputs structured JSON including:
-
-- `task_id`
-- `task_status`
-- `ppt_url`
-- `live_doc_url`
-- `livedoc_short_id`
-- `ppt_business_id`
-- `error_message`
-
-### Step 4: Return structured result
-
-On success, return:
-
-- `ppt_url` immediately (script default output, fallback `live_doc_url`)
-- if `--json` is used, also include `task_id`, terminal status, and optional metadata
-
-## Output Format
-
-Use this response structure:
-
-```markdown
-## PPT Generation Result
-
-- Task ID: <task_id>
-- Status: <status>
-- PPT URL: <ppt_url>
-- Live Doc URL: <live_doc_url or N/A>
-
-## Notes
-
-- livedoc_short_id: <value or N/A>
-- ppt_business_id: <value or N/A>
-```
-
-Error format:
-
-```markdown
-## PPT Generation Failed
-
-- Error Type: <error code or category>
-- Message: <readable message>
-- Suggested Action: <next step>
-```
-
-## Error Handling
-
-Known API error codes:
-
-- `INVALID_API_KEY` (401): key invalid or revoked
-- `PPT_TASK_CREATE_FAILED` (502): create task downstream failed
-- `PPT_TASK_QUERY_FAILED` (502): query task downstream failed
-
-Timeout handling:
-
-- If timeout reached, return last known status and instruct user to retry later
-- Include `task_id` so user can query again
-
-## Important Notes
-
-- Always execute this skill when user intent is slide generation.
-- Always return `task_id` so follow-up queries can continue from the same task.
-- Do not claim completion without a terminal status.
-- Keep API calls minimal: create once, then poll.
-
-## References
-
-- [Felo PPT Task API](https://openapi.felo.ai/docs/api-reference/v2/ppt-tasks.html)
-- [Felo Open Platform](https://openapi.felo.ai/docs/)
+---
+name: felo-slides
+description: "Generate PPT/slides with Felo PPT Task API in Claude Code. Use when users ask to create/make/generate/export presentations or slide decks, or when explicit commands like /felo-slides are used. Handles API key check, task creation, polling, and final ppt_url output."
+---
+
+# Felo Slides Skill
+
+## When to Use
+
+Trigger this skill for requests about creating presentation files:
+
+- Create/generate slides from a topic or outline
+- Turn notes into a PPT deck
+- Build a presentation with a page count requirement
+- Export presentation content into a shareable slide link
+
+Trigger keywords:
+
+- Chinese prompts about making slides or presentations
+- English: slides, PPT, presentation deck, generate presentation
+- Explicit commands: `/felo-slides`, "use felo slides"
+
+Do NOT use this skill for:
+
+- Real-time information lookup (use `felo-search`)
+- Questions about local codebase files
+- Pure text tasks that do not require slide generation
+
+## Setup
+
+### 1. Get API key
+
+1. Visit [felo.ai](https://felo.ai)
+2. Open Settings -> API Keys
+3. Create and copy your API key
+
+### 2. Configure environment variable
+
+Linux/macOS:
+
+```bash
+export FELO_API_KEY="your-api-key-here"
+```
+
+Windows PowerShell:
+
+```powershell
+$env:FELO_API_KEY="your-api-key-here"
+```
+
+## How to Execute
+
+Use Bash tool commands and follow this workflow exactly.
+
+### Step 1: Precheck API key
+
+```bash
+if [ -z "$FELO_API_KEY" ]; then
+  echo "ERROR: FELO_API_KEY not set"
+  exit 1
+fi
+```
+
+If key is missing, stop and return setup instructions.
+
+### Step 2: Run Node Script (create + poll)
+
+Use the bundled script (no `jq` dependency):
+
+```bash
+node felo-slides/scripts/run_ppt_task.mjs \
+  --query "USER_PROMPT_HERE" \
+  --interval 10 \
+  --max-wait 1800 \
+  --timeout 60
+```
+
+Script behavior:
+
+- Creates task via `POST https://openapi.felo.ai/v2/ppts`
+- Polls via `GET https://openapi.felo.ai/v2/tasks/{task_id}/historical`
+- Treats `COMPLETED`/`SUCCESS` as success terminal (case-insensitive)
+- Treats `FAILED`/`ERROR` as failure terminal
+- Stops polling immediately on terminal status
+- Prints `ppt_url` on success (fallback: `live_doc_url`)
+
+Optional debug output:
+
+```bash
+node felo-slides/scripts/run_ppt_task.mjs \
+  --query "USER_PROMPT_HERE" \
+  --interval 10 \
+  --max-wait 1800 \
+  --json \
+  --verbose
+```
+
+This outputs structured JSON including:
+
+- `task_id`
+- `task_status`
+- `ppt_url`
+- `live_doc_url`
+- `livedoc_short_id`
+- `ppt_business_id`
+- `error_message`
+
+### Step 4: Return structured result
+
+On success, return:
+
+- `ppt_url` immediately (script default output, fallback `live_doc_url`)
+- if `--json` is used, also include `task_id`, terminal status, and optional metadata
+
+## Output Format
+
+Use this response structure:
+
+```markdown
+## PPT Generation Result
+
+- Task ID: <task_id>
+- Status: <status>
+- PPT URL: <ppt_url>
+- Live Doc URL: <live_doc_url or N/A>
+
+## Notes
+
+- livedoc_short_id: <value or N/A>
+- ppt_business_id: <value or N/A>
+```
+
+Error format:
+
+```markdown
+## PPT Generation Failed
+
+- Error Type: <error code or category>
+- Message: <readable message>
+- Suggested Action: <next step>
+```
+
+## Error Handling
+
+Known API error codes:
+
+- `INVALID_API_KEY` (401): key invalid or revoked
+- `PPT_TASK_CREATE_FAILED` (502): create task downstream failed
+- `PPT_TASK_QUERY_FAILED` (502): query task downstream failed
+
+Timeout handling:
+
+- If timeout reached, return last known status and instruct user to retry later
+- Include `task_id` so user can query again
+
+## Important Notes
+
+- Always execute this skill when user intent is slide generation.
+- Always return `task_id` so follow-up queries can continue from the same task.
+- Do not claim completion without a terminal status.
+- Keep API calls minimal: create once, then poll.
+
+## References
+
+- [Felo PPT Task API](https://openapi.felo.ai/docs/api-reference/v2/ppt-tasks.html)
+- [Felo Open Platform](https://openapi.felo.ai/docs/)