Agent skill

Felo Slides

Generate PPT/slides from prompts, local images, PDFs, and other files with the Felo PPT Task API.

Install Felo Slides

skills CLI

$ npx skills add Felo-Inc/felo-skills --skill felo-slides -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install Felo-Inc/felo-skills felo-slides --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/Felo-Inc/felo-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/felo-slides .claude/skills/felo-slides && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "felo-slides" agent skill from https://github.com/Felo-Inc/felo-skills/tree/main/felo-slides into .claude/skills/felo-slides/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "felo-slides", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Felo-Inc/felo-skills/tree/main/felo-slides

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Felo-Inc/felo-skills --skill felo-slides -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Felo-Inc/felo-skills felo-slides --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Felo-Inc/felo-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/felo-slides .agents/skills/felo-slides && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "felo-slides" agent skill from https://github.com/Felo-Inc/felo-skills/tree/main/felo-slides into .agents/skills/felo-slides/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "felo-slides", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Felo-Inc/felo-skills --skill felo-slides -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Felo-Inc/felo-skills felo-slides --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Felo-Inc/felo-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/felo-slides .cursor/skills/felo-slides && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "felo-slides" agent skill from https://github.com/Felo-Inc/felo-skills/tree/main/felo-slides into .cursor/skills/felo-slides/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "felo-slides", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Felo-Inc/felo-skills.git --path felo-slides

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Felo-Inc/felo-skills --skill felo-slides -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Felo-Inc/felo-skills felo-slides --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Felo-Inc/felo-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/felo-slides .gemini/skills/felo-slides && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "felo-slides" agent skill from https://github.com/Felo-Inc/felo-skills/tree/main/felo-slides into .gemini/skills/felo-slides/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "felo-slides", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Felo-Inc/felo-skills felo-slides

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Felo-Inc/felo-skills --skill felo-slides -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Felo-Inc/felo-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/felo-slides .github/skills/felo-slides && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "felo-slides" agent skill from https://github.com/Felo-Inc/felo-skills/tree/main/felo-slides into .github/skills/felo-slides/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "felo-slides", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Felo-Inc/felo-skills --skill felo-slides -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Felo-Inc/felo-skills felo-slides --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Felo-Inc/felo-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/felo-slides .opencode/skills/felo-slides && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "felo-slides" agent skill from https://github.com/Felo-Inc/felo-skills/tree/main/felo-slides into .opencode/skills/felo-slides/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "felo-slides", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: felo-slides
GitHub stars: 249
Token cost: ~1.5k tokens
SKILL.md length: 551 words
Files: 5 (incl. scripts)
Skills in repo: 13
Repo updated: Jul 22, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Generate PPT/slides from prompts, local images, PDFs, and other files with the Felo PPT Task API.

Works in 6 steps: Get API key → Configure environment variable → Precheck API key → …
Users ask to create
SKILL.md covers When to Use, Setup, How to Execute and Output Format, plus 3 more sections
Runs JavaScript scripts from its folder; calls node; reaches openapi.felo.ai; needs FELO_API_KEY and INVALID_API_KEY

What it does

Felo Slides is an agent skill from Felo-Inc/felo-skills. Generate PPT/slides from prompts, local images, PDFs, and other files with the Felo PPT Task API. Use when users ask to create, make, generate, or export presentations or slide decks; turn an attached/local file into slides; include an original image in a PPT; or explicitly invoke /felo-slides. Handles file upload, API key checks, task creation, polling, and final ppturl output.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `README.md` and `clawhub.json`).

It sits in Documents & Office, covering Slides and decks. The licence is MIT.

When your agent uses it

Users ask to create
Export presentations
Turn an attached/local file into slides
Include an original image in a PPT

Example prompts

“/felo-slides”

Requirements

Node.js
A credential in FELO_API_KEY
A credential in INVALID_API_KEY

Workflow steps

6 steps, taken from the step headings in SKILL.md.

Get API key
Configure environment variable
Precheck API key
Run Node Script (create + poll)
Confirm terminal status
Return structured result

What it can do on your machine

Read from SKILL.md and the folder at commit b42c3c0. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (JavaScript), which the agent can run.
Shell commands in SKILL.md call:
- node
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- openapi.felo.ai
Also links to:
- felo.ai
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- FELO_API_KEY
- INVALID_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Felo Slides loads about 1.5k tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 551 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~99
When it runs · the whole SKILL.md, loaded when a task matches: ~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Felo-Inc/felo-skills at commit b42c3c0, republished under its MIT licence (© Felo-Inc). 551 words, ~1,499 tokens.

Download SKILL.mdSave it as .claude/skills/felo-slides/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.

name: felo-slides
description: Generate PPT/slides from prompts, local images, PDFs, and other files with the Felo PPT Task API. Use when users ask to create, make, generate, or export presentations or slide decks; turn an attached/local file into slides; include an original image in a PPT; or explicitly invoke /felo-slides. Handles file upload, API key checks, 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 slides from a local image, PDF, or document
Put an uploaded original image into the generated PPT
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

When the user provides a local image or file, pass its absolute path with --file. Include the desired use of the original asset in the prompt. For example:

bash

node felo-slides/scripts/run_ppt_task.mjs \
  --query "Create exactly 2 slides and place the uploaded original image directly in the PPT" \
  --file "/absolute/path/to/source.jpg" \
  --interval 10 \
  --max-wait 1800 \
  --timeout 60

Do not replace --file with a textual description when the user explicitly wants the original file or image used in the PPT.

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

bash

node felo-slides/scripts/run_ppt_task.mjs \
  --query "USER_PROMPT_HERE" \
  --theme "THEME_ID_HERE" \
  --interval 10 \
  --max-wait 1800 \
  --timeout 60

Script behavior:

Creates task via POST https://openapi.felo.ai/v2/ppts
Supports optional --file <path> to upload one local file with multipart/form-data
Supports optional --theme <id> to apply a PPT theme (sends ppt_config.ai_theme_id)
Supports optional --livedoc-id <id> to reuse an existing LiveDoc instead of auto-creating a new one
Supports optional --task-id <id> to resume polling an existing task (skips creation)
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
error_message

Show full SKILL.md (210 more words)Show less

Step 3: Confirm terminal status

The script polls the historical endpoint automatically. Wait for it to exit before responding:

Success: terminal status is COMPLETED or SUCCESS, and the script prints ppt_url (fallback: live_doc_url)
Failure: terminal status is FAILED or ERROR; return the error format below
Timeout: include the task_id and tell the user to resume with --task-id instead of creating a duplicate PPT task

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: To resume a timed-out task, use --task-id instead of --query to avoid creating a duplicate PPT:

bash

node felo-slides/scripts/run_ppt_task.mjs \
  --task-id "TASK_ID_HERE" \
  --interval 10 \
  --max-wait 1800

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

Files

SKILL.md and 4 other files (scripts) in felo-slides of Felo-Inc/felo-skills.

SKILL.md
LICENSE
README.md
clawhub.json
scripts/run_ppt_task.mjs

Open the folder on GitHubat commit b42c3c0

Compare with similar skills

Felo Slides next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Felo Slides compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Felo Slides this skillFelo-Inc/felo-skills	249	—	~1.5k	Automated safety check: Pass	MIT	2 mo ago
Image To Editable Pptningzimu/image-to-editable-ppt-skill	2.8k	—	~4.3k	Automated safety check: Pass	MIT	23 days ago
Slidesfcakyon/claude-codex-settings	1.2k	1 repos	~1.1k	Automated safety check: Pass	MIT	yesterday
Ppt Image FirstNyxTides/ppt-image-first	1.2k	—	~1.6k	Automated safety check: Pass	Apache-2.0	5 mo ago
Vibe to Agentic Engineering Frameworkshanraisshan/claude-code-best-practice	67k	—	~3.3k	Automated safety check: Pass	MIT	today
Gpt Image2 PptJuneYaooo/gpt-image2-ppt-skills	1.3k	—	~8.9k	Automated safety check: Notes	Apache-2.0	1 mo ago

Similar skills

Image To Editable Ppt
ningzimu/image-to-editable-ppt-skill
Rebuild slide images, scanned or image-based PPT/PPTX files, and PDF decks into object-level editable PowerPoint (.pptx), preserving speaker notes when supplied.
2.8k GitHub stars~4.3k tokensUpdated 23 days ago
Documents & OfficeAuto-check passed
Slides
fcakyon/claude-codex-settings
Create and edit presentation slide decks (.pptx) with PptxGenJS, bundled layout helpers, and render/validation utilities.
1.2k GitHub starsUsed in 1 repo~1.1k tokens
Documents & OfficeAuto-check passed
Ppt Image First
NyxTides/ppt-image-first
Build presentation plans for PPT / slides / decks through a conversation-first workflow, then propose multiple visual directions with preview images before writing deck specs.
1.2k GitHub stars~1.6k tokensUpdated 5 mo ago
Documents & OfficeAuto-check passed
Vibe to Agentic Engineering Framework
shanraisshan/claude-code-best-practice
Explains the conceptual model behind a presentation on moving from unstructured vibe coding to fully configured agentic engineering, including its 4-level scoring system and slide conventions.
67k GitHub stars~3.3k tokensUpdated today
Documents & OfficeAuto-check passed
Gpt Image2 Ppt
JuneYaooo/gpt-image2-ppt-skills
Generate visually striking PPT slides via OpenAI's gpt-image-2 -- use any style in styles/<collection/STYLEID.md or mimic a user-supplied .pptx template; outputs high-res slide PNGs and a 16:9 .pptx.
1.3k GitHub stars~8.9k tokensUpdated 1 mo ago
Documents & OfficeAuto-check: notes
Compiledeck
scunning1975/MixtapeTools
Create and compile beautiful Beamer presentations following the Rhetoric of Decks philosophy.
473 GitHub starsUsed in 2 repos~3.1k tokens
Documents & OfficeAuto-check passed

Questions about Felo Slides

What does Felo Slides do?

Generate PPT/slides from prompts, local images, PDFs, and other files with the Felo PPT Task API. Felo Slides is an agent skill from Felo-Inc/felo-skills. Generate PPT/slides from prompts, local images, PDFs, and other files with the Felo PPT Task API.

When should I use Felo Slides?

Felo Slides fits situations like: users ask to create; export presentations; turn an attached/local file into slides; include an original image in a PPT.

How do I install Felo Slides in Claude Code?

Run `npx skills add Felo-Inc/felo-skills --skill felo-slides -a claude-code`. Or copy the skill folder (felo-slides in Felo-Inc/felo-skills) into .claude/skills/felo-slides in your project. Claude Code loads it when a task matches its description.

How do I install Felo Slides in Codex?

Run `npx skills add Felo-Inc/felo-skills --skill felo-slides -a codex`. Or copy the skill folder (felo-slides in Felo-Inc/felo-skills) into .agents/skills/felo-slides in your project. Codex loads it when a task matches its description.

Can I use Felo Slides in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Felo-Inc/felo-skills --skill felo-slides -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/felo-slides, .gemini/skills/felo-slides, .github/skills/felo-slides and .opencode/skills/felo-slides in your project.

What does Felo Slides need to run?

Going by SKILL.md and its folder, Felo Slides needs JavaScript for the scripts in its folder, the command-line tools its instructions call (node) and credentials named FELO_API_KEY and INVALID_API_KEY. Our summary lists: Node.js; A credential in FELO_API_KEY; A credential in INVALID_API_KEY.

Does Felo Slides access the network?

SKILL.md names 2 domains. In commands or code: openapi.felo.ai; the agent is likely to contact it when it follows the instructions. As links in the text: felo.ai. This is read from the text; nothing was executed.

Is Felo Slides safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Felo Slides use?

Felo Slides is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Felo Slides use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Felo Slides?

Skills that share tags, products or a category with Felo Slides: Image To Editable Ppt (ningzimu/image-to-editable-ppt-skill, 2.8k stars), Slides (fcakyon/claude-codex-settings, 1.2k stars), Ppt Image First (NyxTides/ppt-image-first, 1.2k stars) and Vibe to Agentic Engineering Framework (shanraisshan/claude-code-best-practice, 67k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Felo Slides?

Felo-Inc (a GitHub organization) maintains it in Felo-Inc/felo-skills, which has 249 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on July 22, 2026.

Source: Felo-Inc/felo-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Felo Slides

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

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 3: Confirm terminal status

Step 4: Return structured result

Output Format

Error Handling

Important Notes

References

Files

Compare with similar skills

Similar skills

More from Felo-Inc/felo-skills

Related

Questions about Felo Slides