Agent skill

Playwright Healing Agent

by Tahanima in Tahanima/playwright-java-test-automation-architecture

“Expert in diagnosing Playwright failures. Uses the @playwright MCP to verify live DOM state.”

— description from SKILL.md by Tahanima
MITAuto-check passedTesting & QA

Install Playwright Healing Agent

skills CLI
$ npx skills add Tahanima/playwright-java-test-automation-architecture --skill healing-agent -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Tahanima/playwright-java-test-automation-architecture healing-agent --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Tahanima/playwright-java-test-automation-architecture.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.gemini/skills/healing-agent .claude/skills/healing-agent && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
healing-agent
GitHub stars
113
Token cost
~210 tokens
SKILL.md length
96 words
Files
2
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

  • Works in 5 steps: Live Inspection (MANDATORY): Before… → DOM Discovery: Use playwright_click or… → Context Alignment: Load the… → …
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

Playwright Healing Agent is a skill in Tahanima/playwright-java-test-automation-architecture (113 stars). Its SKILL.md is about 210 tokens, with 1 other file in the folder. Licence: MIT.

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Live Inspection (MANDATORY): Before proposing a fix, use the @playwright tool (specifically playwright_navigate) to visit the page where…
  2. DOM Discovery: Use playwright_click or playwright_screenshot to explore the current state of the UI and identify the correct element based…
  3. Context Alignment: Load the corresponding Java class from src/main/java/io/github/tahanima/ui/.
  4. Refactor: Apply the "Healing Logic" from locator-healer.md using the data gathered from the live browser.
  5. Validation: Explain why the new locator works based on what you saw in the live DOM.

What it can do on your machine

Read from SKILL.md and the folder at commit b94e336. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Playwright Healing Agent loads about 210 tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 96 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~27
When it runs · the whole SKILL.md, loaded when a task matches
~210

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Tahanima/playwright-java-test-automation-architecture at commit b94e336, republished under its MIT licence (© Tahanima). 96 words, ~210 tokens.

Download SKILL.mdSave it as .claude/skills/healing-agent/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
healing-agent
description
Expert in diagnosing Playwright failures. Uses the @playwright MCP to verify live DOM state.

Healing Agent Instructions

When a test fails:

  1. Live Inspection (MANDATORY): Before proposing a fix, use the @playwright tool (specifically playwright_navigate) to visit the page where the failure occurred.
  2. DOM Discovery: Use playwright_click or playwright_screenshot to explore the current state of the UI and identify the correct element based on accessibility roles.
  3. Context Alignment: Load the corresponding Java class from src/main/java/io/github/tahanima/ui/.
  4. Refactor: Apply the "Healing Logic" from locator-healer.md using the data gathered from the live browser.
  5. Validation: Explain why the new locator works based on what you saw in the live DOM.

© Tahanima, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .gemini/skills/healing-agent of Tahanima/playwright-java-test-automation-architecture.

  • SKILL.md
  • locator-healer.md

Open the folder on GitHubat commit b94e336

Compare with similar skills

Playwright Healing Agent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Playwright Healing Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Playwright Healing Agent this skillTahanima/playwright-java-test-automation-architecture113—~210Automated safety check: PassMIT
Playwright Testingchongdashu/vibejam-starter-pack149—~2.2kAutomated safety check: PassNone
Debug E2E Testbitovi/ai-enablement-prompts121—~677Automated safety check: PassMIT
Cucumber and Playwright E2E Testslanggenius/dify158k—~682Automated safety check: PassCustom licence
Debugging Opik E2E Testscomet-ml/opik22k—~1.8kAutomated safety check: PassApache-2.0
Playwright E2E Testsonyx-dot-app/onyx32k1 repos~2.8kAutomated safety check: NotesCustom licence

Similar skills

  • Playwright Testing

    chongdashu/vibejam-starter-pack

    Plan, implement, and debug frontend tests: unit/integration/E2E/visual/a11y.

    149 GitHub stars~2.2k tokensUpdated 5 mo ago
    Testing & QAAuto-check passed
  • Debug E2E Test

    bitovi/ai-enablement-prompts

    Debug and fix failing Playwright E2E tests. An agent skill from bitovi/ai-enablement-prompts.

    121 GitHub stars~677 tokensUpdated 29 days ago
    Testing & QAAuto-check passed
  • Guides changes and reviews of the Cucumber and Playwright end-to-end suite under `e2e/`: feature files, step definitions, support code, tags, locators and assertions.

    158k GitHub stars~682 tokensUpdated today
    Testing & QAAuto-check passed
  • Investigates a failed Opik end-to-end test from CI, TestOps or a local run, decides regression versus flake, and proposes a fix without editing tests.

    22k GitHub stars~1.8k tokensUpdated today
    Testing & QAAuto-check passed
  • Playwright E2E Tests

    onyx-dot-app/onyx

    Write and maintain Playwright end-to-end tests for the Onyx application.

    32k GitHub starsUsed in 1 repo~2.8k tokens
    Testing & QAAuto-check: notes
  • Debug Playwright E2E test failures from GitHub Actions CI runs.

    2.8k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed

More from Tahanima/playwright-java-test-automation-architecture

  • Playwright Java QA Review

    Tahanima/playwright-java-test-automation-architecture

    Reviews Playwright-Java test code in phases, checking page-object architecture, then using a Playwright MCP tool to verify shaky locators live.

    113 GitHub stars~561 tokensUpdated 7 mo ago
    Auto-check passed

Categories

Questions about Playwright Healing Agent

How do I install Playwright Healing Agent in Claude Code?

Run `npx skills add Tahanima/playwright-java-test-automation-architecture --skill healing-agent -a claude-code`. Or copy the skill folder (.gemini/skills/healing-agent in Tahanima/playwright-java-test-automation-architecture) into .claude/skills/healing-agent in your project. Claude Code loads it when a task matches its description.

How do I install Playwright Healing Agent in Codex?

Run `npx skills add Tahanima/playwright-java-test-automation-architecture --skill healing-agent -a codex`. Or copy the skill folder (.gemini/skills/healing-agent in Tahanima/playwright-java-test-automation-architecture) into .agents/skills/healing-agent in your project. Codex loads it when a task matches its description.

Can I use Playwright Healing Agent in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Tahanima/playwright-java-test-automation-architecture --skill healing-agent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/healing-agent, .gemini/skills/healing-agent, .github/skills/healing-agent and .opencode/skills/healing-agent in your project.

What does Playwright Healing Agent need to run?

SKILL.md names no scripts, command-line tools or credentials: Playwright Healing Agent is instructions for the agent only.

Does Playwright Healing Agent access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Playwright Healing Agent safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Playwright Healing Agent use?

Playwright Healing Agent is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Playwright Healing Agent use?

About 210 tokens (SKILL.md is roughly 840 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Playwright Healing Agent?

Skills that share tags, products or a category with Playwright Healing Agent: Playwright Testing (chongdashu/vibejam-starter-pack, 149 stars), Debug E2E Test (bitovi/ai-enablement-prompts, 121 stars), Cucumber and Playwright E2E Tests (langgenius/dify, 158k stars) and Debugging Opik E2E Tests (comet-ml/opik, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Playwright Healing Agent?

Tahanima (a GitHub user) maintains it in Tahanima/playwright-java-test-automation-architecture, which has 113 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on February 23, 2026.

Source: Tahanima/playwright-java-test-automation-architecture on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.