{
  "markdown": "# Slidev - Gemini CLI Extension\n\nA professional Gemini CLI extension for creating, editing, and managing [Slidev](https://sli.dev/) presentations—Markdown-based slides for developers.\n\n## ✨ Features\n\n- **⚡ Instant Setup**: Initialize new Slidev projects with best practices and theme selection.\n- **📝 Intelligent Generation**: Create full slide decks with optimal layouts (`two-cols`, `image-right`), animations (`<v-click>`), and speaker notes.\n- **🎨 Smart Editing**: Modify slides using UnoCSS utility classes and refined component usage.\n- **➕ Seamless Addition**: Insert new slides intelligently into existing decks.\n- **📤 Production Export**: Export to PDF/PNG with support for animation steps (`--with-clicks`).\n- **▶️ Dev Server**: Integrated control for starting the local preview server.\n\n### 🚀 Coming Soon (Fase 2)\n\n- **Vue Components Creator:** Automatically generate `/components/Name.vue` files for richer visuals.\n- **Auto-Speaker Notes:** AI will write robust presenter notes directly as HTML comments.\n- **Web Export & Deploy:** One-click `slidev build` and automated deployments.\n- **Agent Skills Migration:** Converting global context to robust `skills/slidev/SKILL.md` (Slidev v52+ standard).\n- **Auto format:** Exposure of the new `/slidev:format` CLI feature.\n\n## 📋 Prerequisites\n\n1. **Gemini CLI** installed and configured (requires Node.js 18+)\n2. **Slidev Environment** requires **Node.js 20.12.0+** and npm/pnpm/yarn\n3. **Slidev** (targets version **v52.14.1+**, installed automatically in new projects)\n\n## 🚀 Installation\n\n### 1. Install Extension\n\nInstall the extension using the `gemini extensions install` command:\n\n```bash\ngemini extensions install https://github.com/professorjoaomiguel/gemini-slidev-extension\n```\n\n### 2. Activate\n\nRestart the Gemini CLI. The following commands will be available:\n\n- `/slidev:init` - Initialize a new Slidev project\n- `/slidev:generate` - Generate complete slide decks from topics\n- `/slidev:add` - Add new slides with specific layouts\n- `/slidev:edit` - Refine content and styles\n- `/slidev:export` - Export presentation to PDF/PNG\n- `/slidev:run` - Start the local development server\n- `/slidev:help` - Show help for the Slidev extension\n- `/slidev` - Main entry point\n\n## 💡 Usage\n\nThe extension provides a suite of commands for the entire presentation lifecycle:\n\n### 🎯 Specific Commands (Recommended)\n\n**Initialize Project:**\n\n```bash\n/slidev:init\n# \"Initialize a new project with the 'seriph' theme\"\n```\n\n**Generate Content:**\n\n```bash\n/slidev:generate \"Deep Learning Fundamentals\"\n# Generates a structured deck with cover, intro, key concepts, and summary\n```\n\n**Add Slides:**\n\n```bash\n/slidev:add \"Comparison of React vs Vue\"\n# Adds a 'two-cols' layout slide comparing the frameworks\n```\n\n**Edit & Refine:**\n\n```bash\n/slidev:edit \"Make the title on slide 3 bigger and red\"\n# Applies 'text-4xl text-red-500' classes using UnoCSS\n```\n\n**Export:**\n\n```bash\n/slidev:export --format pdf --with-clicks\n# Exports a PDF including all animation steps\n```\n\n**Run Server:**\n\n```bash\n/slidev:run\n# Starts the dev server at http://localhost:3030\n```\n\n### 🌟 Natural Language Command (Flexible)\n\n**Open-ended prompts:**\n\n```bash\n/slidev I need a presentation about Rust programming language for beginners\n/slidev Add a slide with a code block showing a Hello World example in Python\n/slidev Export the current deck to PNG\n```\n\n## 🔧 Technical Details\n\n### Core Principles\n\nThis extension adheres to strict quality standards defined in `GEMINI.md`:\n\n- **Markdown-Centric**: Treats `slides.md` as the source of truth.\n- **Component-Driven**: Leverages Slidev's built-in layouts and Vue components.\n- **Progressive Disclosure**: Smart use of animations to control information flow.\n\n### Configuration\n\nThe extension automatically handles:\n\n- YAML Frontmatter validation\n- Component syntax checking\n- Asset path resolution\n\n## 🛠 Local Development\n\nDeveloping extensions for Gemini CLI is a lightweight, iterative process. Use the `link` command to develop locally without reinstalling your extension after every change:\n\n```bash\ncd gemini-slidev-extension\ngemini extensions link .\n```\nChanges to your code are immediately available in the CLI after you restart the session.\n\n## 🩺 Troubleshooting\n\n- **Extension not loading:** If your extension doesn't appear in `/extensions list`, ensure the `gemini-extension.json` is valid and the CLI has been restarted.\n- **Command conflicts:** Remember that user and project commands take precedence over extension commands. Use the prefixed name (e.g., `/slidev:init`) to verify the extension's version. Run `/help` to see a list of all available commands and their sources.\n\n## 🙌 Acknowledgments\n\nThis project (formerly `gemini-slidev-extension-contrib`) evolved into its own independent Pro version, but its architectural concept for custom commands was heavily inspired by the experimental extension from **QIanGua**. We honor their original work as part of our foundation.\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Submit a pull request\n\n## 📄 Legal\n\n- **License**: [Apache License 2.0](LICENSE)\n",
  "bytes": 5138,
  "sha": "aeebc9991f57761ab5939014c02a31ef85f1f3a775b711626e6b8d6a5b720501",
  "repo_slug": "professorjoaomiguel/gemini-slidev",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_professorjoaomiguel_gemini_slidev_4ce211b1/readme"
}