🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Felo Slides
πŸ¦€ ClawHub

Felo Slides

by @comman-kaide

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 c...

Versionv1.0.0
Downloads810
Stars⭐ 2
#legal#productivity
TERMINAL
clawhub install comman-felo-slides

πŸ“– About This Skill

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

    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:

    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:

    ## PPT Generation Result

  • Task ID: 
    • 

  • Status: 
    • 

  • PPT URL: 
    • 

  • Live Doc URL: 
    • Notes
    

  • livedoc_short_id: 
    • 

  • ppt_business_id: 
    •

    Error format:

    ## PPT Generation Failed

  • Error Type: 
    • 

  • Message: 
    • 

  • Suggested Action: 
    •

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

    • ⚑ When to Use

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

    βš™οΈ Configuration

    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"

    πŸ“‹ Tips & Best Practices

  • livedoc_short_id:
  • ppt_business_id: 
    • 
Error format:
    markdown