Simplification Cascades
Simplification Cascades teaches developers to identify unifying principles that eliminate multiple redundant components or special cases. Use this when systems contain similar implementations repeated five or more times, growing exception lists, or excessive configuration options. The skill walks through finding the common underlying pattern, extracting a domain-independent abstraction, and measuring how many separate systems become unnecessary when that abstraction replaces them, turning complex multi-component solutions into single elegant ones.
git clone --depth 1 https://github.com/mrgoonie/claudekit-skills /tmp/simplification-cascades && cp -r /tmp/simplification-cascades/.claude/skills/problem-solving/simplification-cascades ~/.claude/skills/simplification-cascadesSKILL.md
# Simplification Cascades ## Overview Sometimes one insight eliminates 10 things. Look for the unifying principle that makes multiple components unnecessary. **Core principle:** "Everything is a special case of..." collapses complexity dramatically. ## Quick Reference | Symptom | Likely Cascade | |---------|----------------| | Same thing implemented 5+ ways | Abstract the common pattern | | Growing special case list | Find the general case | | Complex rules with exceptions | Find the rule that has no exceptions | | Excessive config options | Find defaults that work for 95% | ## The Pattern **Look for:** - Multiple implementations of similar concepts - Special case handling everywhere - "We need to handle A, B, C, D differently..." - Complex rules with many exceptions **Ask:** "What if they're all the same thing underneath?" ## Examples ### Cascade 1: Stream Abstraction **Before:** Separate handlers for batch/real-time/file/network data **Insight:** "All inputs are streams - just different sources" **After:** One stream processor, multiple stream sources **Eliminated:** 4 separate implementations ### Cascade 2: Resource Governance **Before:** Session tracking, rate limiting, file validation, connection pooling (all separate) **Insight:** "All are per-entity resource limits" **After:** One ResourceGovernor with 4 resource types **Eliminated:** 4 custom enforcement systems ### Cascade 3: Immutability **Before:** Defensive copying, locking, cache invalidation, temporal coupling **Insight:** "Treat everything as immutable data + transformations" **After:** Functional programming patterns **Eliminated:** Entire classes of synchronization problems ## Process 1. **List the variations** - What's implemented multiple ways? 2. **Find the essence** - What's the same underneath? 3. **Extract abstraction** - What's the domain-independent pattern? 4. **Test it** - Do all cases fit cleanly? 5. **Measure cascade** - How many things become unnecessary? ## Red Flags You're Missing a Cascade - "We just need to add one more case..." (repeating forever) - "These are all similar but different" (maybe they're the same?) - Refactoring feels like whack-a-mole (fix one, break another) - Growing configuration file - "Don't touch that, it's complicated" (complexity hiding pattern) ## Remember - Simplification cascades = 10x wins, not 10% improvements - One powerful abstraction > ten clever hacks - The pattern is usually already there, just needs recognition - Measure in "how many things can we delete?"
Create aesthetically beautiful interfaces following proven design principles. Use when building UI/UX, analyzing designs from inspiration sites, generating design images with ai-multimodal, implementing visual hierarchy and color theory, adding micro-interactions, or creating design documentation. Includes workflows for capturing and analyzing inspiration screenshots with chrome-devtools and ai-multimodal, iterative design image generation until aesthetic standards are met, and comprehensive design system guidance covering BEAUTIFUL (aesthetic principles), RIGHT (functionality/accessibility), SATISFYING (micro-interactions), and PEAK (storytelling) stages. Integrates with chrome-devtools, ai-multimodal, media-processing, ui-styling, and web-frameworks skills.
Process and generate multimedia content using Google Gemini API. Capabilities include analyze audio files (transcription with timestamps, summarization, speech understanding, music/sound analysis up to 9.5 hours), understand images (captioning, object detection, OCR, visual Q&A, segmentation), process videos (scene detection, Q&A, temporal analysis, YouTube URLs, up to 6 hours), extract from documents (PDF tables, forms, charts, diagrams, multi-page), generate images (text-to-image, editing, composition, refinement). Use when working with audio/video files, analyzing images or screenshots, processing PDF documents, extracting structured data from media, creating images from text prompts, or implementing multimodal AI features. Supports multiple models (Gemini 2.5/2.0) with context windows up to 2M tokens.
Build robust backend systems with modern technologies (Node.js, Python, Go, Rust), frameworks (NestJS, FastAPI, Django), databases (PostgreSQL, MongoDB, Redis), APIs (REST, GraphQL, gRPC), authentication (OAuth 2.1, JWT), testing strategies, security best practices (OWASP Top 10), performance optimization, scalability patterns (microservices, caching, sharding), DevOps practices (Docker, Kubernetes, CI/CD), and monitoring. Use when designing APIs, implementing authentication, optimizing database queries, setting up CI/CD pipelines, handling security vulnerabilities, building microservices, or developing production-ready backend systems.
Implement authentication and authorization with Better Auth - a framework-agnostic TypeScript authentication framework. Features include email/password authentication with verification, OAuth providers (Google, GitHub, Discord, etc.), two-factor authentication (TOTP, SMS), passkeys/WebAuthn support, session management, role-based access control (RBAC), rate limiting, and database adapters. Use when adding authentication to applications, implementing OAuth flows, setting up 2FA/MFA, managing user sessions, configuring authorization rules, or building secure authentication systems for web applications.
Integrate Bunny.net services (CDN, Storage, Stream, DNS, Edge Scripting, Shield, Magic Containers, Optimizer, Database). Use when building with Bunny.net APIs, deploying to Bunny CDN, uploading files to Edge Storage, managing video streaming, configuring DNS zones, writing edge scripts, setting up WAF/DDoS protection, deploying containers, or optimizing images. Triggers on "bunny", "bunnycdn", "b-cdn", "pull zone", "edge storage", "bunny stream".
Browser automation, debugging, and performance analysis using Puppeteer CLI scripts. Use for automating browsers, taking screenshots, analyzing performance, monitoring network traffic, web scraping, form automation, and JavaScript debugging.
Stage all files and create a commit.