nikeyes · nikeyes · Sep 8, 2026 · Sep 8, 2026 · Sep 8, 2026 · Sep 8, 2026
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -1,6 +1,6 @@
 {
   "name": "stepwise-dev",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "owner": {
     "name": "Jorge Castro",
     "email": "nikeyes@gmail.com"
@@ -36,6 +36,17 @@
       "version": "1.2.0",
       "description": "Multi-agent deep research plugin with parallel web searches and synthesis",
       "keywords": ["research", "multi-agent", "web", "synthesis", "orchestration", "citations"]
+    },
+    {
+      "name": "stepwise-slides",
+      "source": "./slides/plugins/frontend-slides",
+      "version": "1.0.0",
+      "description": "Create beautiful HTML slides from a coding agent — vendored from zarazhangrui/frontend-slides (MIT)",
+      "author": {
+        "name": "Zara Zhang",
+        "url": "https://github.com/zarazhangrui/frontend-slides"
+      },
+      "keywords": ["slides", "presentation", "html", "generative-ui", "vendored"]
     }
   ]
 }
diff --git a/AGENTS.md b/AGENTS.md
@@ -11,7 +11,7 @@ The workflow operates entirely locally without cloud dependencies and uses a `th
 
 ## Multi-Plugin Architecture
 
-This project is distributed as **4 independent Claude Code plugins** in a single marketplace:
+This project is distributed as **5 independent Claude Code plugins** in a single marketplace:
 
 ### Plugin 1: stepwise-core
 **Location**: `core/`
@@ -35,6 +35,11 @@ This project is distributed as **4 independent Claude Code plugins** in a single
 - 1 skill (deep-research, includes generate-report script)
 - 3 specialized agents (research-lead, research-worker, citation-analyst)
 
+### Plugin 5: stepwise-slides
+**Location**: `slides/plugins/frontend-slides/` (vendored from `zarazhangrui/frontend-slides`, MIT)
+**Components**:
+- 1 skill (frontend-slides) with a large template pack
+
 **Installation**:
 ```bash
 # Add marketplace
@@ -45,6 +50,7 @@ claude plugin install stepwise-core@stepwise-dev
 claude plugin install stepwise-git@stepwise-dev
 claude plugin install stepwise-web@stepwise-dev
 claude plugin install stepwise-research@stepwise-dev
+claude plugin install stepwise-slides@stepwise-dev
 ```
 
 See README.md for detailed installation instructions.
@@ -107,6 +113,14 @@ research/              # stepwise-research plugin
         └── scripts/
             └── generate-report
 
+slides/                # stepwise-slides plugin (vendored via git subtree)
+├── LICENSE            # Upstream MIT — preserved for attribution
+└── plugins/frontend-slides/
+    ├── .claude-plugin/plugin.json
+    └── skills/frontend-slides/
+        ├── SKILL.md
+        └── ...        # template pack
+
 codex/                 # OpenAI Codex compatibility layer
 ├── agents/*.toml      # 9 generated agent definitions
 ├── transpile-agents.sh
@@ -126,6 +140,7 @@ claude plugin install stepwise-core@stepwise-dev
 claude plugin install stepwise-git@stepwise-dev
 claude plugin install stepwise-web@stepwise-dev
 claude plugin install stepwise-research@stepwise-dev
+claude plugin install stepwise-slides@stepwise-dev
 # Restart Claude Code
 
 # That's it! All components are included in the respective plugins
@@ -314,6 +329,31 @@ never the skill: it loads and runs on the session's model, which is what `inheri
 asks for anyway. The key stays because Claude Code needs it.
 
 
+## Vendored plugins
+
+`stepwise-slides` is imported verbatim from
+[`zarazhangrui/frontend-slides`](https://github.com/zarazhangrui/frontend-slides)
+(MIT, author Zara Zhang) under the `slides/` prefix via `git subtree`. Upstream
+attribution is preserved via `slides/LICENSE`.
+
+Do **not** edit files under `slides/`. Every future `git subtree pull` must
+succeed without conflicts; if divergence is needed, wrap the upstream skill
+externally instead of patching in place.
+
+Optional sync one-liner (run manually, on demand):
+
+```bash
+git subtree pull \
+  --prefix=slides \
+  https://github.com/zarazhangrui/frontend-slides.git \
+  main --squash
+```
+
+If the pull brings meaningful changes, patch-bump `stepwise-slides` in both
+`plugin.json`-mirroring entries per `.claude/rules/versioning.md`.
+
 ## Attribution
 
 This project is derived from [HumanLayer](https://github.com/humanlayer/humanlayer) and adapted for local-only operation. All `.claude/` components are modified versions licensed under Apache License 2.0.
+
+`stepwise-slides` is vendored from [zarazhangrui/frontend-slides](https://github.com/zarazhangrui/frontend-slides) by Zara Zhang under the MIT License.
diff --git a/README.md b/README.md
@@ -34,7 +34,7 @@ The faster AI generates code, the more these practices matter:
 
 ## 📦 Available Plugins
 
-This repository contains **4 independent plugins** that can be installed separately based on your needs:
+This repository contains **5 independent plugins** that can be installed separately based on your needs:
 
 ### 1. **stepwise-core** (Core Workflow)
 The foundation plugin with the complete Research → Plan → Implement → Validate cycle.
@@ -74,6 +74,12 @@ Advanced multi-agent research system with parallel web searches and synthesis.
 
 [→ Read more](./research/README.md)
 
+### 5. **stepwise-slides** (HTML Slide Decks)
+Generate beautiful HTML presentations from a coding agent. **Vendored** from [zarazhangrui/frontend-slides](https://github.com/zarazhangrui/frontend-slides) (MIT, author Zara Zhang).
+
+**Includes:**
+- 1 skill (`frontend-slides`) with a large template pack
+
 ## 🚀 Installation
 
 ### Option 1: Install All Plugins (Recommended for first-time users)
@@ -86,6 +92,7 @@ claude plugin install stepwise-core@stepwise-dev
 claude plugin install stepwise-git@stepwise-dev
 claude plugin install stepwise-web@stepwise-dev
 claude plugin install stepwise-research@stepwise-dev
+claude plugin install stepwise-slides@stepwise-dev
 ```
 
 ### Option 2: Install Only What You Need
@@ -105,6 +112,9 @@ claude plugin install stepwise-web@stepwise-dev
 
 # Optionally add multi-agent deep research
 claude plugin install stepwise-research@stepwise-dev
+
+# Optionally add HTML slide generation (vendored)
+claude plugin install stepwise-slides@stepwise-dev
 ```
 
 **Restart Claude Code after installation.**
@@ -138,7 +148,7 @@ The same skills also run under OpenAI Codex.
 
 This installs:
 
-- **16 skills** symlinked into `~/.agents/skills/` (13 from core, 2 from git, 1 from research) — Codex follows symlinks when scanning that directory, so edits in the repo take effect immediately
+- **17 skills** symlinked into `~/.agents/skills/` (13 from core, 2 from git, 1 from research, 1 from vendored slides) — Codex follows symlinks when scanning that directory, so edits in the repo take effect immediately
 - **9 agents** copied into `~/.codex/agents/` as TOML, generated from the agent markdown by `codex/transpile-agents.sh`
 
 Regenerate the agents after editing any `*/agents/*.md` with `make transpile-codex`; `make check-codex` fails if they're out of sync.
@@ -282,8 +292,22 @@ claude plugin update stepwise-core@stepwise-dev
 claude plugin update stepwise-git@stepwise-dev
 claude plugin update stepwise-web@stepwise-dev
 claude plugin update stepwise-research@stepwise-dev
+claude plugin update stepwise-slides@stepwise-dev
 ```
 
+### Syncing vendored plugins
+
+`stepwise-slides` is imported from upstream via `git subtree`. To pull the latest upstream changes:
+
+```bash
+git subtree pull \
+  --prefix=slides \
+  https://github.com/zarazhangrui/frontend-slides.git \
+  main --squash
+```
+
+Do **not** edit files under `slides/` — every future sync must apply cleanly. If the pull brings meaningful changes, patch-bump `stepwise-slides` in `.claude-plugin/marketplace.json` and the top-level marketplace `version` per `.claude/rules/versioning.md`.
+
 ## 📝 Golden Rules
 
 1. **Keep context under 60%** — past that, accuracy drops.
@@ -373,6 +397,8 @@ Apache License 2.0 - See LICENSE file for details.
 
 Derived from [HumanLayer's Claude Code workflow](https://github.com/humanlayer/humanlayer/tree/main/.claude) under Apache License 2.0.
 
+`stepwise-slides` is vendored verbatim from [zarazhangrui/frontend-slides](https://github.com/zarazhangrui/frontend-slides) (MIT, author Zara Zhang) under the `slides/` prefix, imported via `git subtree`.
+
 Several skills are derived from [Matt Pocock's skills](https://github.com/mattpocock/skills) (grill-me, tdd), [eferro's skill-factory](https://github.com/eferro/skill-factory) (hamburger-method, small-safe-steps, story-splitting, test-desiderata, and tdd/zombies reference) and [Gojko Adzic's BugMagnet](https://github.com/gojko/bugmagnet-ai-assistant). See [NOTICE](NOTICE) for detailed attribution.
 
 **Major enhancements**:

diff --git a/codex/install.sh b/codex/install.sh
@@ -11,7 +11,10 @@ AGENTS_DIR="$HOME/.codex/agents"
 mkdir -p "$SKILLS_DIR" "$AGENTS_DIR"
 
 count=0
-for skill in "$REPO_ROOT"/core/skills/*/ "$REPO_ROOT"/git/skills/*/ "$REPO_ROOT"/research/skills/*/; do
+for skill in "$REPO_ROOT"/core/skills/*/ \
+             "$REPO_ROOT"/git/skills/*/ \
+             "$REPO_ROOT"/research/skills/*/ \
+             "$REPO_ROOT"/slides/plugins/frontend-slides/skills/*/; do
   case "$skill" in *-workspace/*) continue ;; esac
   [ -f "$skill/SKILL.md" ] || continue
 

diff --git a/slides/.claude-plugin/marketplace.json b/slides/.claude-plugin/marketplace.json
@@ -0,0 +1,18 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "frontend-slides",
+  "description": "Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files.",
+  "owner": {
+    "name": "zarazhangrui",
+    "url": "https://github.com/zarazhangrui"
+  },
+  "plugins": [
+    {
+      "name": "frontend-slides",
+      "description": "Zero-dependency HTML presentation generator with safe presets, bold template-library styles, PPT conversion, and anti-AI-slop design philosophy.",
+      "source": "./plugins/frontend-slides",
+      "category": "productivity",
+      "tags": ["presentations", "slides", "html", "design", "powerpoint", "templates"]
+    }
+  ]
+}
diff --git a/slides/.gitignore b/slides/.gitignore
@@ -0,0 +1,5 @@
+.DS_Store
+.claude-design/
+node_modules/
+.vercel/
+*.log
diff --git a/slides/LICENSE b/slides/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zara Zhang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.