Skip to content

v2.0.0 — Progressive Disclosure Restructure

Choose a tag to compare

@zarazhangrui zarazhangrui released this 04 Mar 06:54

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 scriptscripts/extract-pptx.py can 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-slides

All existing functionality is preserved — same 12 style presets, same 5-phase workflow, same PPT conversion support.