| name | walkietalkie-themes |
| description | Specialized skill for the Talky/WalkieTalkie theme system (19 themes, GPU shaders, custom fonts, sound packs, Pro gating). Use this when the user asks to add/create/new/modify/design a theme, fix theme colors, change palette, add animated particle backgrounds, register fonts, wire ThemeSoundManager, fix ThemeRegistry (which is MISSING in the codebase), add localization keys for themes, adjust Pro-locking logic, modify ThemeSelectorView or ThemePurchaseSheet, or debug theme-related build failures. Also trigger on phrases like "lava theme", "new animated theme", "the palette doesn't look right", "ThemeRegistry not found", "theme.name.hacker missing". This skill understands all 19 Theme enum cases, the 3 pack files (ColorPack, IdentityPack, AnimatedPack), the ThemeMetadata struct, the Canvas-based GPU particle engine in AnimatedBackgroundView, and the bridge-key Pro gating system. It can generate complete theme code from a natural-language description, dispatch parallel agents for independent tasks, and call frontend-design-open for design review. Use this INSTEAD of the generic walkietalkie-ios skill when the task is theme-specific, even partially.
|
Talky Theme System — Skill Specializzata
Progetta, crea, modifica e debugga il sistema temi di Talky (19 temi, GPU shader, font custom, sound pack, Pro gating).
Integrazione con Superpowers
Questa skill sfrutta le superpowers:
dispatching-parallel-agents — per creare pack file + localizzazioni + shader in parallelosubagent-driven-development — per piani strutturati multi-filefrontend-design-open — per revisione estetica delle palette generate
Non caricare tutte le reference insieme. Leggi solo quella che serve al task corrente.
Reference Files
| File | Quando leggerlo |
|---|
references/theme-architecture.md | Capire come funziona il sistema, risolvere bug, fare refactoring |
references/theme-creation-workflow.md | Aggiungere un nuovo tema (step-by-step) |
references/gpu-shader-templates.md | Creare/modificare temi animati (Canvas particle engine) |
references/design-guidelines.md | Generare palette, scegliere icone, font, sound pack |
Workflow: Creare un Nuovo Tema
- Leggi
references/design-guidelines.md per progettare la palette
- Leggi
references/theme-creation-workflow.md per la checklist completa
- Se animato → leggi anche
references/gpu-shader-templates.md
- Usa agenti paralleli per task indipendenti:
- Un agente scrive il pack file + enum case
- Un agente aggiunge le localizzazioni in 5 lingue
- Un agente scrive lo shader (se animato)
- Verifica con
xcodebuild (comando in fondo)
PRIMA di tutto: Controlla ThemeRegistry
Il progetto ha ThemeRegistry mancante. È referenziato in 3 file (Theme.swift:49, ThemePurchaseSheet.swift:45, ThemeSoundManager.swift:33,41) ma non esiste. Se non è già stato creato, la build fallisce. Prima di fare qualunque altra cosa:
- Crea
ThemeRegistry (un enum con static var registry: [Theme: ThemeMetadata])
- Chiama i 3 pack
register(into:) in un blocco static func bootstrap()
- Usa
static func metadata(for theme: Theme) -> ThemeMetadata come accessor
enum ThemeRegistry {
private static var registry: [Theme: ThemeMetadata] = {
var dict: [Theme: ThemeMetadata] = [:]
ThemeColorPack.register(into: &dict)
ThemeIdentityPack.register(into: &dict)
ThemeAnimatedPack.register(into: &dict)
return dict
}()
static func metadata(for theme: Theme) -> ThemeMetadata {
guard let meta = registry[theme] else {
fatalError("ThemeRegistry: missing metadata for \(theme.rawValue)")
}
return meta
}
}
Pattern di Progettazione Palette
Quando generi un tema da descrizione naturale (es. "un tema lava"), segui queste regole:
Colori
- Sfondo: sempre scuro (RGB < 0.20). Se .gradient, gradientTop 10-20% più scuro di gradientBottom
- Testo primario: bianco o quasi bianco (0.88-1.0)
- Testo secondario: ~65% dell'opacità del primario
- Accent glow: accentColor con opacità 0.14-0.26
- Card:
.elevated: surfaceColor ~2x brighter di backgroundPrimary.cyber: surfaceColor ~1.5-2x brighter, dà effetto "vetro".flat: surfaceColor ~1.3x brighter, minimale
Icone (SF Symbols)
Scegli icona tematica. Esempi dai temi esistenti:
water.waves, leaf.fill, sun.horizon.fill, moon.stars.fillshield.lefthalf.filled, sparkles, dial.high.fill, bolt.filleye.slash.fill, cloud.sun.fill, dot.radiowaves.left.and.rightantenna.radiowaves.left.and.right, party.popper.fillcircle.dashed, terminal.fill, flame.fill, snowflake
Font
- Usa
nil (system) per la maggior parte dei temi
"Courier New" — militare, tecnico, industriale"Courier" — retro, vintage tech"Georgia" — elegante, naturale, classico"Menlo" — cyber, tech, moderno
Sound Pack
"morse" — militare, tattico"synth" — retrowave, synthwave"glitch" — cyberpunk, hacker"sonar" — subacqueo, radar"radio" — radioamatore, vintage radionil — per la maggior parte dei temi
Debug
Tema non si applica
- Controlla
UserDefaults.standard.string(forKey: "selected_theme")
- Controlla bridge keys:
fastboot_isProUser, fastboot_hasThemesPack
- Verifica che il case enum sia in
Theme.allCases
Build error: "ThemeRegistry"
C'è! È il bug noto. Crea ThemeRegistry come descritto sopra.
Animazione non parte
backgroundStyle == .animated nel metadata?- Caso switch in
AnimatedBackgroundView.body?
reduceMotion non sta forzando la fallback statico?
Traduzione mancante
Le chiavi theme.name.hacker, theme.name.wildfire, theme.name.arctic mancano in TUTTE le 5 lingue. Vanno aggiunte.
Verifica Build
xcodebuild -project "WalkieTalkie.xcodeproj" -scheme WalkieTalkie -destination 'platform=iOS Simulator,name=iPhone 16' build 2>&1 | tail -20
Riepilogo Temi Esistenti
| ID | Nome | Free/Pro | Stile sfondo | Font | Sound | Shader |
|---|
default | Default | FREE | .solid | — | — | — |
ocean | Ocean | Pro | .gradient | — | — | — |
forest | Forest | Pro | .gradient | — | — | — |
sunset | Sunset | Pro | .gradient | — | — | — |
midnight | Midnight | Pro | .gradient | — | — | — |
military | Military | Pro | .solid | Courier New | morse | — |
retro80s | Retro 80s | Pro | .gradient | Courier | synth | — |
vintageRadio | Vintage Radio | Pro | .solid | Georgia | — | — |
cyberpunk | Cyberpunk | Pro | .gradient | Menlo | glitch | — |
stealth | Stealth | Pro | .solid | Courier New | — | — |
aurora | Aurora | Pro | .gradient | Georgia | — | — |
submarine | Submarine | Pro | .gradient |
