Agent skill

Easyslides

by Rimagination in Rimagination/easyslides

Canonical EasySlides entry point for creating, distilling, editing, reviewing, and exporting editable academic PPTX presentations.

MITAuto-check passedDocuments & Office

Install Easyslides

skills CLI
$ npx skills add Rimagination/easyslides --skill easyslides -a claude-code

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

GitHub CLI
$ gh skill install Rimagination/easyslides easyslides --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/Rimagination/easyslides.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/easyslides .claude/skills/easyslides && 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/

Facts

Skill name
easyslides
GitHub stars
138
Token cost
~1.7k tokens
SKILL.md length
750 words
Files
2
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Canonical EasySlides entry point for creating, distilling, editing, reviewing, and exporting editable academic PPTX presentations.

  • Works in 4 steps: SKILL.md, the complete route and… → ARCHITECTURE.md, the layer model and… → workflows/routing.md, deterministic… → …
  • The user explicitly says EasySlides/easyslides
  • SKILL.md covers Required startup reading, Mandatory production-scheme…, Mandatory reconstruction-mode… and Chinese wording defaults, plus 2 more sections
  • Calls python

What it does

Easyslides is an agent skill from Rimagination/easyslides. Canonical EasySlides entry point for creating, distilling, editing, reviewing, and exporting editable academic PPTX presentations. Use whenever the user explicitly says EasySlides/easyslides or asks for PPTX distillation, a content-free reusable template, template/component/symbol extraction, template reuse, thesis-defense or research slides, slide reconstruction, native PowerPoint preview, or visual QA, including 蒸馏PPT、提取PPT模板、 拆分组件与符号资产、复用模板、论文汇报PPT和答辩PPT。

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Documents & Office, covering PowerPoint presentations and Slides and decks. It works with Microsoft PowerPoint. The licence is MIT.

When your agent uses it

  • The user explicitly says EasySlides/easyslides
  • Asks for PPTX distillation
  • A content-free reusable template
  • Template/component/symbol extraction

Example prompts

  • “/easyslides”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. SKILL.md, the complete route and execution contract.
  2. ARCHITECTURE.md, the layer model and supported capability paths.
  3. workflows/routing.md, deterministic route selection for the request.
  4. skills/easyslides-clarify/SKILL.md, the blocking user-choice gate.

What it can do on your machine

Read from SKILL.md and the folder at commit fe4882b. 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

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Easyslides loads about 1.7k tokens when it runs. Until then it costs about 118 tokens; SKILL.md has 750 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Rimagination/easyslides at commit fe4882b, republished under its MIT licence (© Rimagination). 750 words, ~1,674 tokens.

Download SKILL.mdSave it as .claude/skills/easyslides/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
easyslides
description
Canonical EasySlides entry point for creating, distilling, editing, reviewing, and exporting editable academic PPTX presentations. Use whenever the user explicitly says EasySlides/easyslides or asks for PPTX distillation, a content-free reusable template, template/component/symbol extraction, template reuse, thesis-defense or research slides, slide reconstruction, native PowerPoint preview, or visual QA, including 蒸馏PPT、提取PPT模板、 拆分组件与符号资产、复用模板、论文汇报PPT和答辩PPT。

EasySlides Academic PPTX

EasySlides is a repository-backed Codex plugin. This skill is a thin adapter around the canonical operating guide at ../../SKILL.md; read that file completely before executing a presentation task.

Required startup reading

From the plugin/repository root, read:

  1. SKILL.md, the complete route and execution contract.
  2. ARCHITECTURE.md, the layer model and supported capability paths.
  3. workflows/routing.md, deterministic route selection for the request.
  4. skills/easyslides-clarify/SKILL.md, the blocking user-choice gate.

Run the clarification gate before selecting a route whenever the request is ambiguous. Then read the specific workflow selected by the routing guide. For a source PPTX that should become a reusable template, invoke the plugin-local skills/easyslides-distill/SKILL.md first, followed by the PPTX, template-reuse, and template-spec guidance selected by workflows/pptx-to-easyslides-template.md. Do not invent a second PPTX export backend: use the existing SVG/shape IR to DrawingML/PPTX pipeline or the documented native PPTX route.

The plugin-local skills are authoritative. Treat separately installed legacy skills such as ppt-distill, easyppt, or easyslides-template-reuse as compatibility references only; do not let them replace this canonical route or reintroduce source-slide-order filling.

Mandatory production-scheme choice

The default intake is an adaptive native-popup conversation. Ask one meaningful question, use its answer to choose the next, and skip already explicit facts. Do not open a browser guide or require a form unless the user explicitly asks. When the brief is executable, summarize it and proceed without repeated approval.

For academic content, read references/academic-orchestration.md before intake. Inspect supplied material contents and roles; establish research permission, audience, intended outcome, speaking time, visual preference and preservation boundaries. Its evidence and storytelling workflow applies to every template and production scheme, subject to the requested editing scope.

Before making a new or regenerated PPT, MUST ask which production scheme to use unless the user already explicitly selected one for this task. Wait for the answer; do not silently pick a route from the input format, a template, imagegen, or a general request for editability. No automatic default. Use the exact three-option question in workflows/clarification-gate.md. This is required even when the rest of the request is unambiguous.

Mandatory reconstruction-mode choice

In both choice rounds, MUST show Token 消耗 and 耗时 levels for every option before the user chooses. Explain that levels are relative estimates adjusted for scope and complexity, not exact usage or promised time; disclose image generation separately. Follow the cost and time disclosure in the clarification workflow.

For image reconstruction, confirm 全图矢量重建 (full_vector) or 保留复杂配图 (preserve_complex_images) through workflows/clarification-gate.md before execution. No automatic default, even for “快点做”; reuse only an explicit choice in the same task. Both modes require native PPT text boxes. Preserve one source line in one text box, merging OCR fragments and using text runs for mixed styling; keep independent labels and table cells separate. Full-vector mode needs approval before any raster exception. Partial rebuilds apply this within selected regions. When a source region is identified as tabular, declare it as native_table in the inventory and mark its SVG handoff with data-pptx-table="true"; the exporter emits a real PowerPoint table with measured rows, columns, cells and merge metadata.

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

Chinese wording defaults

For complete ImageGen slides, use the reference-image payload, recorded result, and generation-manifest handoff in workflows/slide-image-to-editable-pptx.md. An existing image file alone is insufficient proof of generation. Each approved image is the visual source for its reconstructed page. Never substitute another template shell. Require delivery_ready=true plus actual source/render review.

Default to “垂听”, not “聆听”, in authored Chinese PPT text, including closings such as “感谢垂听,敬请讨论”. Apply this preference to imagegen prompts and editable slide text alike; see the full rule in ../../SKILL.md.

Runtime conventions

  • Run commands from the plugin/repository root.
  • Use python scripts/easyslides.py --help to discover the command hub.
  • Keep generated projects and private source material under the existing ignored project/output locations.
  • Preserve the existing templates, references, workflows, and QA gates.
  • Never place API keys, tokens, or private source material in committed files.

Common command entry points

powershell
python scripts/easyslides.py --help
python scripts/easyslides.py clarify --help
python scripts/easyslides.py project --help
python scripts/easyslides.py source-to-md --help
python scripts/easyslides.py distill --help
python scripts/easyslides.py semantic-render --help
python scripts/easyslides.py template-gate --help
python scripts/easyslides.py review --help
python scripts/easyslides.py workflow --help

For PPTX-to-template work, use the same command hub:

powershell
python scripts/easyslides.py distill "path\to\source.pptx" --template-id my_template

Before selecting a cover, TOC, transition, or ending variant from a functional_page_variants.json registry, run the named-slot geometry gate:

powershell
python scripts/functional_page_variant_adapter.py <template_dir> --role toc --check-all

This gate is fail-closed. It rejects variants whose editable text slots overlap or whose same slot id occupies multiple independent text boxes, because those defects otherwise become duplicated or mutually obscured text in the native PPTX export. Repair the SVG geometry or choose another variant before rendering content.

The plugin is intentionally lightweight: the repository remains the runtime, template library, and source of truth. Add a dedicated MCP server only after a stable command contract is demonstrated by the existing CLI and tests.

© Rimagination, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/easyslides of Rimagination/easyslides.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit fe4882b

Compare with similar skills

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

Easyslides compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Easyslides this skillRimagination/easyslides138—~1.7kAutomated safety check: PassMIT
BeamerNoi1r/beamer-skill364—~13kAutomated safety check: NotesMIT
Paper2slidesQuZhan51496/paper2anything450—~3.8kAutomated safety check: NotesApache-2.0
Xiaobei Skill Image To Vbaxiao24bei/xiaobei-skill586—~6.9kAutomated safety check: PassApache-2.0
Powerpoint SlidesNoi1r/powerpoint-skill124—~12kAutomated safety check: NotesMIT
Academic WritingZimoLiao/scholaraio577—~827Automated safety check: PassMIT

Similar skills

  • Beamer

    Noi1r/beamer-skill

    Beamer LaTeX slide workflow: create, compile, review, and polish academic presentations.

    364 GitHub stars~13k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Paper2slides

    QuZhan51496/paper2anything

    Turn an academic paper PDF into a presentation deck (.pptx) end-to-end.

    450 GitHub stars~3.8k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes
  • Xiaobei Skill Image To Vba

    xiao24bei/xiaobei-skill

    A skill your agent uses when users want XiaoBei skill / xiaobei-skill / 小北在读研 style academic image-to-VBA reconstruction: convert academic figures, scientific diagrams, slides, screenshots, or other…

    586 GitHub stars~6.9k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Powerpoint Slides

    Noi1r/powerpoint-skill

    Create visually rich PowerPoint (.pptx) presentations from academic papers, research notes, or any content the user wants in slide format.

    124 GitHub stars~12k tokensUpdated 6 mo ago
    Documents & OfficeAuto-check: notes
  • Academic Writing

    ZimoLiao/scholaraio

    A skill your agent uses when the user needs help choosing or organizing an academic-writing workflow by deliverable, stage, or format, including review articles, guided reading, paper sections, PPT…

    577 GitHub stars~827 tokensUpdated 15 days ago
    Documents & OfficeAuto-check passed
  • Nano Banana

    EvoScientist/EvoSkills

    Generate professional presentation slides and high-quality illustrations using Gemini image generation API (Nano Banana 2), with interactive browser-based review and iterative editing.

    478 GitHub starsUsed in 2 repos~3.5k tokens
    Documents & OfficeAuto-check passed

More from Rimagination/easyslides

  • Easyslides

    Rimagination/easyslides

    Use EasySlides to create, distill, edit, review, and export editable academic PPTX presentations, including 蒸馏PPT、提取模板、复用模板和答辩PPT。

    138 GitHub stars~12k tokensUpdated 27 days ago
    Auto-check passed
  • Easyslides Clarify

    Rimagination/easyslides

    Resolve only result-affecting ambiguities in an EasySlides request through explicit user choices before route selection or generation.

    138 GitHub stars~1.9k tokensUpdated 27 days ago
    Auto-check passed
  • Easyslides Distill

    Rimagination/easyslides

    Distill a source PPTX with EasySlides into factual source evidence, a content-free semantic layout family, and real reusable component and symbol assets.

    138 GitHub stars~4.7k tokensUpdated 27 days ago
    Auto-check passed

Questions about Easyslides

What does Easyslides do?

Canonical EasySlides entry point for creating, distilling, editing, reviewing, and exporting editable academic PPTX presentations. Easyslides is an agent skill from Rimagination/easyslides. Canonical EasySlides entry point for creating, distilling, editing, reviewing, and exporting editable academic PPTX presentations.

When should I use Easyslides?

Easyslides fits situations like: the user explicitly says EasySlides/easyslides; asks for PPTX distillation; A content-free reusable template; template/component/symbol extraction.

How do I install Easyslides in Claude Code?

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

How do I install Easyslides in Codex?

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

Can I use Easyslides 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 Rimagination/easyslides --skill easyslides -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/easyslides, .gemini/skills/easyslides, .github/skills/easyslides and .opencode/skills/easyslides in your project.

What does Easyslides need to run?

Going by SKILL.md and its folder, Easyslides needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Easyslides access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Easyslides 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. Review the folder before installing.

What licence does Easyslides use?

Easyslides is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Easyslides use?

About 1.7k tokens (SKILL.md is roughly 6.7k 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 Easyslides?

Skills that share tags, products or a category with Easyslides: Beamer (Noi1r/beamer-skill, 364 stars), Paper2slides (QuZhan51496/paper2anything, 450 stars), Xiaobei Skill Image To Vba (xiao24bei/xiaobei-skill, 586 stars) and Powerpoint Slides (Noi1r/powerpoint-skill, 124 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Easyslides?

Rimagination (a GitHub user) maintains it in Rimagination/easyslides, which has 138 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on September 13, 2026.

Source: Rimagination/easyslides on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.