jorgempenalva/slides

Overview

This skill generates branded Slidev presentations and exports them as PDF. It automatically discovers your project's brand colors, scaffolds Slidev markdown with a branded style block, and produces a ready-to-download PDF deck.

How this skill works

On each request the skill resolves brand colors by checking a saved presentations/brand.json and then searching common places (Tailwind config, CSS variables, design tokens, package.json, or markdown notes). It builds Slidev markdown using configurable layout patterns, inserts a CSS <style> block mapping the brand palette to variables, writes the file to presentations/output/<slug>.md, and runs slidev export to create presentations/output/<slug>.pdf. If no brand colors are found, it asks the user for a source or a hex and derives a full palette when only a single color is provided.

When to use it

• You need a quick, branded slide deck from a natural language prompt.
• Preparing a presentation for a meeting, board update, or conference talk.
• Converting structured content (topics, bullets, slide count) into Slidev markdown and PDF.
• Generating consistent slides that match your project’s existing design tokens or Tailwind theme.
• When you want an editable Slidev source plus a generated PDF export.

Best practices

• Provide a clear title, key topics, and desired slide count (default 6–8) up front.
• If brand colors are not detected, supply a primary hex or link to a design file to avoid prompts.
• Review the generated presentations/brand.json to confirm or tweak the palette before more decks.
• Use the layout patterns (title, bullets, two-column, table, blockquote) to guide content structure.
• Keep images and detailed diagrams as separate assets referenced in the content so they export cleanly.

Example use cases

• Create an 8-slide deck summarizing a microservices migration: current state, target architecture, timeline, risks, team allocation.
• Generate a board update deck covering revenue, customer acquisition, product roadmap, and hiring plan.
• Produce a product demo presentation with title slide, feature highlights, comparison table, and next steps.
• Draft a conference talk with title, agenda, key insights (blockquote), and closing call-to-action.
• Convert a structured brief into Slidev markdown and a PDF for immediate sharing.