Starstruk Logo MarkStarstruk

v2.0.0

EricLBuehler/mistral.rsv2.0.0Mar 4, 2026by zarazhangrui

AI Summary

frontend-slides v2.0.0 implements a progressive disclosure architecture that reduces context bloat by 89%, transforming the skill from a 1,625-line monolithic file to a 183-line core map with on-demand loading of supporting files.

Key Highlights

  • ~89% reduction in context bloat
  • Progressive disclosure pattern for on-demand file loading
  • Deduplicated viewport CSS into single canonical file
  • Embedded design aesthetics prompt for anti-AI-slop
  • Executable PPT extraction script

New Features

  • Progressive disclosure architecture
  • 12 curated visual presets (loaded in Phase 2)
  • Mandatory responsive CSS (viewport-base.css)
  • HTML structure and JS features (html-template.md)
  • CSS/JS animation reference (animation-patterns.md)
  • PPT content extraction script (extract-pptx.py)
  • Embedded design aesthetics prompt
  • Updated README with new architecture explanation

Full Release Notes

## What's New

This release completely restructures the skill to reduce context bloat by ~89%, following best practices from [Claude Code's skill docs](https://code.claude.com/docs/en/skills) and [OpenAI's harness engineering](https://openai.com/index/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.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

```bash
# 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.