v2.0.0 — Progressive Disclosure Restructure
What's New
This release completely restructures the skill to reduce context bloat by ~89%, following best practices from Claude Code's skill docs and OpenAI's harness engineering approach.
The Problem
The previous version loaded 1,625 lines of instructions into Claude's context on every invocation — including CSS code blocks, Python scripts, and HTML templates that were only needed during specific phases. This crowded out the actual presentation content and reduced output quality.
The Fix: Progressive Disclosure
SKILL.md is now a 183-line map (was 1,098). Supporting files are loaded on-demand only when Claude reaches the relevant phase:
| File | Purpose | Loaded When |
|---|---|---|
SKILL.md |
Core workflow and rules | Always |
STYLE_PRESETS.md |
12 curated visual presets | Phase 2 (style selection) |
viewport-base.css |
Mandatory responsive CSS | Phase 3 (generation) |
html-template.md |
HTML structure and JS features | Phase 3 (generation) |
animation-patterns.md |
CSS/JS animation reference | Phase 3 (generation) |
scripts/extract-pptx.py |
PPT content extraction | Phase 4 (conversion) |
Other Changes
- Deduplicated viewport CSS — was repeated across both files, now lives in one canonical
viewport-base.css - Embedded design aesthetics prompt — anti-AI-slop instructions are now always in context
- PPT extraction is now an executable script —
scripts/extract-pptx.pycan be run directly - Removed ~566 lines of duplication — total content is 1,059 lines (down from 1,625)
- Updated README with new architecture explanation
Upgrading
# Re-clone to your skills directory
rm -rf ~/.claude/skills/frontend-slides
git clone https://github.com/zarazhangrui/frontend-slides.git ~/.claude/skills/frontend-slidesAll existing functionality is preserved — same 12 style presets, same 5-phase workflow, same PPT conversion support.