The heal-spec skill automates the maintenance of demo-as-code specifications created with demo-machine. When a UI change breaks a demo script—such as a modified CSS selector, updated button text, or moved element—this skill analyzes failure artifacts including HTML snapshots, error logs, and screenshots to diagnose the root cause and apply a resilient fix. By prioritizing stable selectors like ARIA roles and test IDs, it transforms manual troubleshooting into an automated recovery process, ensuring product demos remain synchronized with the latest software version with minimal manual intervention.
주요 기능
01Automated failure diagnosis using DOM, JSON logs, and screenshot analysis
02Comprehensive reporting of diagnostic logic and applied spec changes
032 GitHub stars
04Automatic classification of failures including timeouts, text changes, and intercepted clicks
05Intelligent selector migration from fragile CSS to resilient ARIA roles and test IDs
06Integrated validation and re-run testing to verify patches immediately
사용 사례
01Updating demo assertions and narration when marketing copy or product labels change
02Repairing demo scripts after a frontend framework update or UI component refactor
03Resolving flaky demo steps caused by timing issues or missing wait states