felo-slides

Original：🇺🇸 English

Translated

1 scripts

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.

2installs

Sourcefelo-inc/felo-skills

Added on2026-03-06

NPX Install

npx skill4agent add felo-inc/felo-skills felo-slides

SKILL.md Content

View Translation Comparison →

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

Visit felo.ai
Open Settings -> API Keys
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
```

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.

felo-slides

NPX Install

Tags

SKILL.md Content

Felo Slides Skill

When to Use

Setup

1. Get API key

2. Configure environment variable

How to Execute

Step 1: Precheck API key

Step 2: Run Node Script (create + poll)

Step 4: Return structured result

Output Format

Error Handling

Important Notes

References