CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

awt-e2e-testing

AI-powered E2E web testing — eyes and hands for AI coding tools. Declarative YAML scenarios, Playwright execution, visual matching (OpenCV + OCR), platform auto-detection (Flutter/React/Vue), learning DB. Install: npx skills add ksgisang/awt-skill --skill awt -g

Quality

64%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/awt-e2e-testing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

47%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body functions as a marketing-style overview: lean and readable, but it teaches Claude almost nothing actionable beyond installing the skill. The core usage workflow and scenario format are absent, making the skill unusable from SKILL.md alone.

Suggestions

Add a minimal quick-start workflow: a short example YAML scenario, the command to execute it, and what a pass/fail result looks like.

Include a step-by-step sequence for the core loop (author scenario → run via Playwright → interpret failure diagnosis → consult learning DB), with an explicit validation/retry checkpoint on failure.

Bundle the YAML scenario syntax, provider setup (Claude/OpenAI/Gemini/DeepSeek/Ollama), and diagnosis-checklist details as reference files (e.g., references/scenarios.md, references/providers.md) and link them from clearly labeled sections.

DimensionReasoningScore

Conciseness

The body is short (~20 lines) with clear sections and no explanation of concepts Claude already knows; it is genuinely token-efficient. It misses 5 only because of a few promotional lines that earn no place — "Built with the help of AI coding tools — and designed to help AI coding tools test better" and "Actively developed by a solo developer at AILoopLab. Feedback welcome!" — which are minor trimmable padding, not the several unnecessary explanations required for level 3 or below.

4 / 5

Actionability

The only executable guidance is the install command "npx skills add ksgisang/awt-skill --skill awt -g"; everything else is a feature list ("YAML scenarios → Playwright", "Structured failure diagnosis with investigation checklists") and external links. There are no example scenarios, no commands to run a test, and no steps for actually using the tool — high-level hints missing the specific steps to execute, matching anchor 2; it is not 1 because one concrete command is present.

2 / 5

Workflow Clarity

At best a rough two-step notion exists ("Your AI designs YAML test scenarios; AWT executes them with Playwright"), but the workflow a user actually needs — author a scenario, run it, interpret failure diagnosis, apply learning-DB fixes — is entirely unsequenced with many gaps and no validation or feedback-loop checkpoints. This fits anchor 2; it is not 1 because the design→execute sequence is at least hinted, and not 3 because no steps are actually listed.

2 / 5

Progressive Disclosure

The body is well-organized into "What works now" and "Links" sections, with clearly signaled one-level-deep pointers to the main repo, skill repo, and cloud demo. It scores 4 rather than 5 because the detailed materials the skill obviously needs (YAML scenario syntax, provider configuration, diagnosis checklists) are not bundled as reference files — the body only points at external GitHub homepages — leaving a minor organization gap.

4 / 5

Total

12

/

20

Passed

Description

66%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description does a solid job stating what the skill does, with specific, credible technology terms. Its main deficiency is the complete absence of when-to-use trigger guidance, which caps completeness and limits its usefulness for skill selection.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user asks to run E2E/end-to-end or browser tests, verify a web app's UI visually, or test without writing CSS selectors".

Include common synonyms such as "end-to-end testing", "browser automation", and "UI testing" to broaden natural trigger coverage.

Drop the metaphorical "eyes and hands for AI coding tools" flourish in favor of a concrete action verb phrase.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — "Declarative YAML scenarios, Playwright execution, visual matching (OpenCV + OCR), platform auto-detection (Flutter/React/Vue), learning DB" — with specific technologies named. It falls short of 5 because these are feature nouns rather than performed actions, and the metaphorical "eyes and hands for AI coding tools" adds no concrete information; it exceeds 3 because coverage goes well beyond 1-2 actions.

4 / 5

Completeness

The "what" is clearly stated (E2E web testing via YAML scenarios executed with Playwright), but there is no "Use when..." clause or equivalent trigger guidance anywhere — when to invoke the skill is not even weakly implied. Per the rubric guideline, a missing explicit trigger caps completeness at 3, and the description matches anchor 3 exactly; it is not 2 because the "what" is not vague.

3 / 5

Trigger Term Quality

Natural terms users would say include "E2E web testing", "Playwright", "visual matching", and "OCR", giving good keyword coverage of the testing domain. A few common variations are missing (e.g., "end-to-end testing" spelled out, "browser automation", "UI testing"), which keeps it below 5 but above the partial-coverage level 3.

4 / 5

Distinctiveness Conflict Risk

The niche — YAML-scenario E2E web testing with visual matching for AI coding tools — is mostly distinct, anchored by specific terms like "Declarative YAML scenarios" and "OpenCV + OCR". Minor overlap risk remains with generic test-writing or Playwright-helper skills (a user asking to "write Playwright tests" could trigger it), so it does not reach the clear-niche level 5, but it is more specific than the overlap-prone level 3.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/awt-e2e-testing/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.