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

2. Configure environment variable

Linux/macOS:

CODEBLOCK0

Windows PowerShell:

CODEBLOCK1

How to Execute

Use Bash tool commands and follow this workflow exactly.

Step 1: Precheck API key

CODEBLOCK2

If key is missing, stop and return setup instructions.

Step 2: Run Node Script (create + poll)

Use the bundled script (no jq dependency):

CODEBLOCK3

To apply a specific theme, first list available themes with felo ppt-themes, then pass the theme ID:

CODEBLOCK4

Script behavior:

• - Creates task via INLINECODE4
• Supports optional --theme <id> to apply a PPT theme (sends ppt_config.ai_theme_id)
• Supports optional --task-id <id> to resume polling an existing task (skips creation)
• Polls via INLINECODE8
• 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:

CODEBLOCK5

This outputs structured JSON including:

• - INLINECODE15
• INLINECODE16
• INLINECODE17
• INLINECODE18
• INLINECODE19
• INLINECODE20
• INLINECODE21

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:

CODEBLOCK6

Error format:

CODEBLOCK7

Error Handling

Known API error codes:

• - INVALID_API_KEY (401): key invalid or revoked
• INLINECODE27 (502): create task downstream failed
• INLINECODE28 (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: To resume a timed-out task, use --task-id instead of --query to avoid creating a duplicate PPT:

CODEBLOCK8

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
• Felo Open Platform