felo-slides

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: 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 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: - 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: - 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 Weekly Installs185Repositoryfelo-inc/felo-skillsGitHub Stars100First Seen12 days agoSecurity AuditsGen Agent Trust HubPassSocketPassSnykPassInstalled oncursor178codex178opencode178gemini-cli177github-copilot177amp177