Guide · Agent skill
How to use the Report to Google Slides agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The report-to-google-slides skill is a narrow tool for one job: when you explicitly ask, it converts an existing local HTML analytics report into a native Google Slides deck that a stakeholder can skim. This guide is for analysts and teams who already have a finished HTML report and want a briefing deck without rebuilding slides by hand. By the end you will know what the skill does, how to install it, how to phrase a request that triggers it, and what it needs to run.
Report to Google SlidesXiaomiMiMo/MiMo-Code · MIT Download the skill Quick start
- 1Download and unzip the skill. Download the skill ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder.
- 2Confirm requirements. Check that Python 3, the unzip tool and a Google Drive connector with import and thumbnail tools are available, and that your Google account can create presentations.
- 3Prepare the HTML report. Make sure you have the real, local HTML report with an absolute file path, not a sign-in page or a remote URL.
- 4Ask for the conversion explicitly. Request the conversion by name, including the full path to the HTML file and the words Google Slides.
- 5Let the helper build the deck. The agent runs the bundled Python helper, which writes deck.pptx and its preflight checks to the output folder.
- 6Import and review in Google Slides. The agent imports the PPTX into Google Slides and inspects the outline and slide thumbnails for problems.
- 7Open the deck link. Review the returned Google Slides link, check the caveats and sources slides, and share it only with the right people.
What an agent skill is and what this one does
An agent skill is a folder of instructions and optional scripts that an AI agent loads when a task matches its description. This skill's description says it should be invoked only when you explicitly ask to convert an existing HTML analytics report into a native Google Slides deck.
The output is meant to be a deck, not a pasted copy of the report. The skill aims to keep the headline claim, executive summary, major findings, metric definitions, material charts, decision-critical tables, recommendations, caveats and source notes, so a stakeholder can understand the answer without opening the original report.
- Reads a local HTML report, preferably self-contained HTML.
- Runs a bundled Python helper that builds a PowerPoint file and local quality checks.
- Imports the PPTX into Google Slides through a Google Drive connector.
- Checks slide thumbnails and returns the Google Slides link.
Install the report-to-google-slides skill
Download the ZIP for this skill from this page and unzip it. For a personal install, place the skill folder in ~/.claude/skills/. For a single project, place it in that project's .claude/skills/ folder.
You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.
- Personal install: ~/.claude/skills/report-to-google-slides
- Project install: .claude/skills/report-to-google-slides inside your project
- Claude apps: Settings → Capabilities → Skills, then upload the skill
~/.claude/skills/Set up what the skill requires
The skill needs Python 3 to run its bundled report_to_google_slides.py helper, and the unzip command-line tool to verify the generated PPTX. The import step depends on a Google Drive connector that exposes the import and outline/thumbnail tools, and on a Google account with permission to create presentations in Drive.
- Python 3
- unzip command-line tool
- A Google Drive connector exposing the import and outline/thumbnail tools (mcp__codex_apps__google_drive)
- A Google account allowed to create presentations in Drive
How to trigger the skill with a natural request
The skill is designed to run only when you clearly ask for this conversion. Name the source HTML file by its full path and say you want a Google Slides deck. Vague requests such as 'make slides' may not match the skill's narrow scope.
The skill expects an absolute file path to a local HTML file, so give the full path where possible.
- "Convert /Users/me/reports/q3-retention.html into a Google Slides deck for the exec team."
- "Turn this existing HTML analytics report into native Google Slides with editable tables."
- "Use the report-to-google-slides skill on /home/me/analysis/churn_report.html."
What happens during a run
The agent resolves the local HTML report and runs the helper with an output folder, by default /tmp/report_to_google_slides in the example command. The helper writes deck.pptx, manifest.json, deck_plan.json, preflight_checks.json and an assets/ folder of rendered chart images.
The agent imports deck.pptx only after preflight_checks.json reports a passed status, then checks the outline and thumbnails of the imported slides. If thumbnails show clipped text, missing charts or blank images, the agent is told to revise and regenerate before handing you the link.
- Output files: deck.pptx, manifest.json, deck_plan.json, preflight_checks.json, assets/
- Routine check details stay in support files unless a check failed or needs your attention.
python3 <REPORT_TO_GOOGLE_SLIDES_SKILL_DIR>/scripts/report_to_google_slides.py \
<LOCAL_HTML_REPORT_PATH> \
--out-dir /tmp/report_to_google_slidesSafety notes: scripts and network use
This skill runs scripts and uses the network. The deck is uploaded to Google Drive through your connected account, so the report content leaves your machine. Do not use it on sensitive or confidential reports unless you are comfortable with that upload.
If you only have a PDF, a spreadsheet or a remote URL, the skill is a poor fit. It expects a local HTML file and tells the agent to create one from other sources first, which adds work and can drift from the original evidence.
- The helper is a Python script bundled in the skill folder; read it before running if you need to audit it.
- Google Drive import requires a connected account with permission to create presentations.
- Remote reports must be retrieved outside the skill first.
Tips for better decks
Self-contained HTML works best, because the skill supports charts provided as inline SVG, accessible tables or embedded images. If the file is a sign-in page, a redirect or a very small stub, the skill stops and asks for the real report.
Review the imported deck yourself before sharing. The skill checks thumbnails, but you know your audience and the message you need.
- Use self-contained HTML with inline SVG or embedded images for charts.
- Confirm the report is the real file, not a login or redirect page.
- Check the speaker notes and source slides, which hold extra detail that did not fit on the main slides.
- Keep the Google Slides link private if the report is sensitive.
What people use it for
- Briefing an executive team on a finished quarterly HTML analytics report with a short editable deck.
- Turning a self-contained HTML churn or retention report into slides with native charts and tables for a stakeholder review.
- Sharing a findings deck with caveats and recommendations kept visible on the source slides for a cross-team meeting.
- Producing a Google Slides version of an existing report for colleagues who edit decks in Google Workspace.
Frequently asked questions
How do I install the report-to-google-slides skill?
Download the skill ZIP from this page and unzip it into ~/.claude/skills/ for a personal install, or into a project's .claude/skills/ folder for one project. You can also upload it in the Claude apps under Settings → Capabilities → Skills.
What do I need to run it?
You need Python 3 for the bundled helper, the unzip command-line tool, a Google Drive connector exposing the import and outline/thumbnail tools, and a Google account with permission to create presentations in Drive.
Can it convert a PDF, spreadsheet or URL to Google Slides?
Not directly. The skill expects a local HTML file. For other sources, the agent is told to first create an equivalent local HTML report, which adds work and can drift from the original evidence. Remote reports must be retrieved outside the skill first.
Is the report content private when I use this skill?
No. The deck is uploaded to Google Drive through your connected account, so the report content leaves your machine. Avoid it for sensitive or confidential reports unless that upload is acceptable.
Why won't the skill run on my request?
The skill is designed to run only when you explicitly ask to convert an existing HTML analytics report into a native Google Slides deck. Name the HTML file by its full path and say Google Slides. Also confirm the Google Drive connector is set up, since the import step depends on it.
Is the skill free and what is its licence?
The source lists the licence as MIT. The source does not state any price, so check the directory page and the licence file in the skill for terms.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you are an analyst or team with a finished, self-contained HTML analytics report, a Google Workspace account and a working Google Drive connector, and you want an editable Google Slides briefing deck. Pick something else if your source is a PDF, spreadsheet or URL, if the report is confidential and must stay on your machine, or if you cannot connect Google Drive.
Download the skill