skills.rest
45ck
45ckCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

heal-spec

Patch broken demo-machine specs by analyzing failure artifacts and validating with the CLI.

6|1|Updated Feb 14, 2026
Search Tags:#automation#playwright#self-healing#failure-analysis#heal#demo-spec
One-click install
npx skills add https://github.com/45ck/demo-machine --skill heal-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: heal-spec
Source: https://github.com/45ck/demo-machine/tree/main/.claude/skills/heal-spec
Command: npx skills add https://github.com/45ck/demo-machine --skill heal-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically fix a broken demo spec by analyzing failure artifacts (screenshots, DOM, error logs). Use when a demo fails after a UI change.

Core Features & Use Cases

  • Diagnose failures by parsing failure.json, failure.html, failure.png, and events.json.
  • Automatically patch failing selectors, add waits, and adjust navigation to restore successful runs.
  • Provide patch diffs and commands to validate and re-run the demo.

Quick Start

Point the heal-spec tool at a failing spec and its failure artifacts to generate a repaired spec and validate it with the CLI.

Frequently Asked Questions about heal-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I auto-fix failing Playwright specs after UI changes?▼

You can automatically patch a broken demo spec by analyzing failure artifacts such as failure.json, failure.html, and failure.png. The tool parses these artifacts to update failing selectors, add waits, and adjust navigation to restore successful runs.

What does self-healing test automation use to diagnose demo spec failures?▼

Self-healing test automation uses failure artifacts including failure.json, failure.html, failure.png, and events.json to diagnose demo spec failures. These files provide the screenshots, DOM snapshots, and error logs needed to identify broken selectors.

Can I validate patched selectors and re-run a demo spec automatically?▼

Yes, you can validate patched selectors and re-run a demo spec automatically. After updating selectors and steps, the tool validates changes with the CLI and can re-run the demo to confirm the fix.

What do I need to provide to start healing a broken demo spec?▼

To start healing a broken demo spec, you need the failing spec file and its corresponding failure artifacts like failure.json, failure.html, and failure.png. Point the tool at these inputs to generate a repaired spec and validate it with the CLI.

Does this self-healing spec tool work without manually inspecting failure screenshots?▼

Yes, it works without manual inspection. The tool automatically reads failure.png, failure.html, and failure.json to diagnose the failure, generate patch diffs, and update selectors without needing human review of the screenshots.

Why does my demo spec fail after a UI change and how do I patch it?▼

Your demo spec fails after a UI change because selectors and navigation steps become outdated. You can patch it by parsing failure artifacts to update failing selectors, add waits, and adjust navigation to restore successful runs.

Related Skills

Explore More Software Engineering Skills→
45ck45ck
6

review-demo

Analyze event logs, timing, and narration to report demo quality issues.

Community
Intermediate
navapbcnavapbc
6

tickets-health

Identify and remediate health issues on tracked tasks after creation and relation updates.

Official
Intermediate
Xza85hrfXza85hrf

agentic-testing

Run disposable Playwright scripts capturing screenshots, video, and DOM snapshots.

Community
Advanced
anhtesteranhtester
129

Locator Healer Agent

Repair broken UI locators in Playwright or Selenium Page Objects.

Community
Intermediate