Locator Healer Agent

Community

anhtester

Skill tự động phát hiện và sửa chữa locators bị hỏng khi automation tests fail do thay đổi DOM.

Overview

Publisher	anhtester
Repository	`antigravity-testing-kit`
Skill name	`Locator Healer Agent`
Stars	149
Forks	57
Bundled files	Instructions only
License	MIT
Links	Skill source Repository Homepage

Markdown instructions
A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.
Works with any LLM
AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.
Self-contained
Everything the model needs lives in the instructions — no extra files to sync.
Open source
Published by anhtester on GitHub. Read the source before you install it.

Installation

Install the Locator Healer Agent AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
https://github.com/anhtester/antigravity-testing-kit/tree/main/.agent/skills/locator_healer_agent
Enable the skill in any chat where you want it available.

Store

Installed

Skills

Add skills

Import one or more skills from a public GitHub folder or a local .skill or .zip archive, or SKILL.md file.

From GitHub URLFrom .skill, .zip, or SKILL.md

GitHub repo or folder

https://github.com/anhtester/antigravity-testing-kit/tree/main/.agent/skills/locator_healer_agent

Points to a single skill folder, or any folder that contains multiple skills. Public repos only.

CancelContinue

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

git clone --depth 1 https://github.com/anhtester/antigravity-testing-kit.git /tmp/antigravity-testing-kit
mkdir -p .claude/skills
cp -r /tmp/antigravity-testing-kit/.agent/skills/locator_healer_agent .claude/skills/anhtester-locator-healer-agent

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Locator Healer Agent in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Locator Healer Agent on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Locator Healer Agent is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed
The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.
Switch models mid-chat
Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Locator Healer Agent

Purpose: Automatically repair broken locators when automation tests fail.

When to Use

Use this skill when:

A test fails with "element not found" or "element detached" errors
UI has changed and existing locators no longer work
After a frontend deployment that modifies DOM structure

Responsibilities

When a locator fails:

Inspect current DOM or UI hierarchy
Compare old locator with current page structure
Identify updated attributes
Generate a replacement locator
Re-run test to verify the fix

Detection Strategy

Locator is considered broken when:

Element not found (NoSuchElementException / TimeoutError)
Element detached from DOM
Selector matches zero elements
Selector matches wrong element (different text/position)

Healing Workflow

Step 1: Analyze the Error

Read error log to identify which locator failed
Identify the Page Object file and line number

Step 2: Inspect Current DOM

Open the page using MCP tools
Navigate to the same state as the failing test
Inspect the target area in DOM

Step 3: Find Alternative Locator

Try the following in priority order:

Accessibility attributes (aria-label, role)
data-testid / data-test
id (if stable, not auto-generated)
Semantic locator (Playwright getByRole, getByLabel)
css selector (stable attributes)
xpath (relative, not positional)

Step 4: Validate & Replace

Verify the new locator matches exactly one element
Verify the element is the correct one (text, position, behavior)
Replace the broken locator in the Page Object class
Re-run the test

Difference from Smart Locator Agent

Aspect	Locator Healer	Smart Locator
Trigger	Test failure (reactive)	New element (proactive)
Input	Broken locator + error log	HTML/DOM element
Goal	Fix existing locator	Generate new locator
Workflow	Error → Inspect → Replace → Verify	Inspect → Generate → Validate

Verification

After healing:

Locator must match exactly one element
Element is the correct target (verify text/attributes)
Test must pass successfully
Locator is stable across page reloads

Rules References

.agent/rules/locator_strategy.md — Master locator priority map
.agent/rules/automation_rules.md — General automation best practices

Frequently asked questions

What does the Locator Healer Agent AI skill do?

Skill tự động phát hiện và sửa chữa locators bị hỏng khi automation tests fail do thay đổi DOM.

Why use Locator Healer Agent on TypingMind?

Because you install it once and use it with any model. Locator Healer Agent is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Locator Healer Agent in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/anhtester/antigravity-testing-kit/tree/main/.agent/skills/locator_healer_agent. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Locator Healer Agent?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Locator Healer Agent?

As many as you like. As long as a model supports skills, you can use Locator Healer Agent with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Locator Healer Agent AI skill free?

Yes. It is published on GitHub by anhtester under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Mle Workflow

affaan-m

CommunityPopular

Production machine-learning engineering workflow for data contracts, reproducible training, model evaluation, deployment, monitoring, and rollback. Use when building, reviewing, or hardening ML…

Diagnosing Bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

E2e Testing

Patrones de pruebas E2E con Playwright, Page Object Model, configuración, integración CI/CD, gestión de artefactos y estrategias para pruebas inestables.

Eval Harness

Framework formal de evaluación para sesiones de Claude Code que implementa principios de desarrollo orientado a evals (EDD)

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

Locator Healer Agent

When to Use

Responsibilities

Detection Strategy

Healing Workflow

Step 1: Analyze the Error

Step 2: Inspect Current DOM

Step 3: Find Alternative Locator

Step 4: Validate & Replace

Difference from Smart Locator Agent

Verification

Rules References

Frequently asked questions

Related AI Skills

Set up your own AI workspace now