Starstruk Logo MarkStarstruk

v2.0.0

KoljaB/RealtimeTTSv2.0.0Mar 4, 2026by zarazhangrui

AI Summary

This release completely restructures the frontend-slides skill to reduce context bloat by approximately 89% by implementing progressive disclosure for supporting files, consolidating CSS, and embedding design aesthetics.

Key Highlights

  • Reduced context bloat by ~89% (from 1,625 to 1,059 lines) via progressive disclosure.
  • Consolidated duplicated viewport CSS into a single canonical `viewport-base.css` file.
  • Embedded design aesthetics prompt for anti-AI-slop instructions.
  • Converted PPT extraction into a standalone executable script.
  • Updated README with new architecture explanations.

New Features

  • Embedded design aesthetics prompt
  • Executable PPT extraction script

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.