Skip to content

claude.md

Latest commit

 

History

History
75 lines (51 loc) · 2.51 KB

claude.md

File metadata and controls

75 lines (51 loc) · 2.51 KB

Claude Setup And Usage

This guide is for running slides-grab with Claude Code and shared Vercel-installed skills.

1) Install the npm Package

npm install slides-grab
npx playwright install chromium

Verify:

slides-grab --help

2) Install Claude Code Skills

From the local npm install:

npx skills add ./node_modules/slides-grab -g -a claude-code --yes --copy

Then restart Claude Code so the shared skills are loaded.

3) Developer / Repo Clone Path

If you want to work on slides-grab itself:

git clone https://github.com/vkehfdl1/slides-grab.git && cd slides-grab
npm ci
npx playwright install chromium
npx skills add . -g -a claude-code --yes --copy

Installed skill names:

  • slides-grab-plan
  • slides-grab-design
  • slides-grab-export
  • slides-grab

4) Run Commands During Workflow

Use one workspace folder per deck:

Prerequisite: create or generate decks/my-deck/ with slide-*.html first. These commands do not work against an empty clone.

slides-grab edit --slides-dir decks/my-deck
slides-grab build-viewer --slides-dir decks/my-deck
slides-grab validate --slides-dir decks/my-deck
slides-grab image --slides-dir decks/my-deck --prompt "Editorial hero image for slide 03"
slides-grab pdf --slides-dir decks/my-deck --output decks/my-deck.pdf
slides-grab pdf --slides-dir decks/my-deck --mode print --output decks/my-deck-searchable.pdf
slides-grab convert --slides-dir decks/my-deck --output decks/my-deck.pptx
slides-grab figma --slides-dir decks/my-deck --output decks/my-deck-figma.pptx

slides-grab convert and slides-grab figma are experimental / unstable. Treat their output as best-effort and expect manual cleanup in PowerPoint or Figma.

slides-grab pdf defaults to --mode capture for visual fidelity. Use --mode print when searchable/selectable text is more important than pixel-perfect browser parity.

When a slide needs bespoke generated imagery, use slides-grab image --prompt "..." --slides-dir <path> with GOOGLE_API_KEY (or GEMINI_API_KEY) set. If no key is available, ask for one or fall back to web search + local download into assets/.

5) Recommended Claude Kickoff Prompt

Copy-paste into Claude:

Read docs/installation/claude.md first and follow it exactly. Install slides-grab with npm, install the shared skills from ./node_modules/slides-grab using Vercel Agent Skills, use slides-grab-plan/design/export (or slides-grab), keep each deck in decks/<deck-name>, and run validate before conversion.
⚡