felo-slides

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
2. Open Settings -> API Keys
3. Create and copy your API key

2. Configure environment variable

Linux/macOS:

export FELO_API_KEY="your-api-key-here"

Windows 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

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). To reduce black-box waiting and make task progress easier to track, prefer --json --verbose as the default mode:

node .agents/skills/felo-slides/scripts/run_ppt_task.mjs \
  --query "USER_PROMPT_HERE" \
  --interval 10 \
  --max-wait 1800 \
  --timeout 60 \
  --json \
  --verbose

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 task_id to stderr when running in observable mode
• Prints ppt_url on success (fallback: live_doc_url)
• Includes richer error details such as code / request_id when Felo returns them

Optional debug output:

node .agents/skills/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:

## 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:

## 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

• ⚠️ 路徑安全：skill 腳本位於 repo root 的 .agents/skills/ 下。若 cwd 不在 repo root，先執行 git rev-parse --show-toplevel 取得路徑再 cd。禁止用 $(...) 語法。
• ⚠️ 指令安全：Copilot CLI 的安全過濾器會封鎖含有特定 shell 語法的指令，執行時禁止加入以下任何寫法，否則指令會被直接擋下：
  • set -e、set -u、set -o、set -euo pipefail 等 set 指令
  • ${var@P}、${!var} 等參數展開語法
  • 巢狀的 $(...) 指令替換
  • 正確寫法：直接執行 cd 與 node 指令，不要包在 shell 腳本控制流程內
• 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
• Felo Open Platform