CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

qa-happy-path

Drive a web application's UI through core positive flows using Playwright browser automation. Verify that primary user journeys work end-to-end, take snapshots at each step, and report bugs with full reproduction details. Trigger on "run happy path tests", "test the UI flows", "QA the happy path", "verify the user journey", or when a test plan defines UI flows.

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

70%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 content is well organized with distinct operating modes, explicit validation checkpoints, and concrete file/env-var guidance, making the testing workflow easy to follow. Its main weaknesses are redundancy (Modes A–C are restated in both the Workflow and Examples sections) and a progressive-disclosure design whose referenced `rules/` files are absent from the bundle, leaving the CRITICAL and HIGH-impact rules unreadable.

Suggestions

Ship the five referenced `rules/*.md` files in the bundle (or inline the CRITICAL test-plan rule into the body) — the Shared Standards table currently points at files that do not exist, making the CRITICAL and HIGH-impact rules unenforceable.

Eliminate the triple statement of the same three modes: either drop the "Workflow" and "Examples" sections or merge them, keeping only one full description of Modes A–C plus one worked example per mode.

Trim the "Persona" section ("Role: Senior QA Engineer, 7 years of experience") and the "Positive Trigger/Non-Trigger" block, which duplicate the opening paragraph and the frontmatter triggers without adding actionable guidance.

DimensionReasoningScore

Conciseness

The body is mostly efficient but carries several padded or redundant sections: the "Workflow" section restates the mode detection and execution steps already detailed in Modes A–C, the "Examples" section restates each mode a third time, "Positive Trigger/Non-Trigger" duplicates the frontmatter triggers, and the "Persona" block ("Role: Senior QA Engineer, 7 years of experience") adds little actionable value. It sits between the 2 anchor ('several unnecessary padded sections') and the 4 anchor ('minor instances of over-explanation') — the core modes and troubleshooting sections are tight, but the triple-statement of the same three modes is more than minor.

3 / 5

Actionability

Guidance is largely executable and specific: exact file paths (`.qa/test-plan.md`, `.env.qa`, `.qa/config.yml`), exact env var names (`QA_PORTAL_URL`, `QA_TEST_USER_EMAIL`/`QA_TEST_USER_PASSWORD`), a verbatim disambiguation question, a structured output-format template, and a troubleshooting entry with a concrete install command (`claude mcp add playwright -- npx @anthropic-ai/mcp-playwright`). It is not a 5 because key steps defer to `rules/*.md` files that are not in the bundle, leaving e.g. the bug-report format unresolvable — a real gap, though most in-body guidance is complete.

4 / 5

Workflow Clarity

Mode A is a clear 9-step sequence with explicit validation checkpoints — "After each action: take a snapshot to verify UI state" and "check network requests to confirm success" after submits — plus per-step pass/fail reporting and a defined error-recovery path (bug found → `rules/rpt-bug.md`). The troubleshooting section supplies error/cause/solution loops. This matches the 5 anchor (clear sequence, explicit validation, feedback loops); the operations are not destructive, so the validation cap does not apply.

5 / 5

Progressive Disclosure

The on-page structure is good: a rules table with file paths and impact ratings clearly signals one-level-deep references, and the body appropriately stays an overview. However, scored against the actual bundle structure, the bundle contains only SKILL.md — all five referenced `rules/` files (`rules/_sections.md`, `rules/std-test-plan.md`, `rules/ui-snapshot.md`, `rules/ui-network.md`, `rules/rpt-bug.md`) are missing, including the CRITICAL test-plan rule, so the navigation is broken. This places it between the 3 anchor ('some structure; references present but not clearly resolved') and the 4 anchor ('good structure; references mostly clear; minor organization gaps') — the design is right but the referenced files dangle.

3 / 5

Total

15

/

20

Passed

Description

88%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.

A strong description: concrete, third-person capability statements paired with an explicit and natural set of trigger phrases. Minor room for improvement lies in trigger synonym coverage and sharpening the two broader trigger phrases against neighboring testing skills.

DimensionReasoningScore

Specificity

The description lists four concrete actions spanning the skill's full range: "Drive a web application's UI through core positive flows using Playwright browser automation", "Verify that primary user journeys work end-to-end", "take snapshots at each step", and "report bugs with full reproduction details". This matches the anchor for multiple specific concrete actions with comprehensive coverage; the anchor below (4, 'minor gaps in coverage') would apply only if a core capability were omitted, which it is not.

5 / 5

Completeness

Both questions are answered explicitly: the 'what' is the two opening sentences of concrete capabilities, and the 'when' is an explicit trigger clause with concrete quoted phrases ("Trigger on 'run happy path tests', 'test the UI flows', ..."). This is a direct match for the 5 anchor ('clearly and explicitly answers both what AND when with concrete trigger phrases'); the 4 anchor applies only when the 'when' is present but less explicit.

5 / 5

Trigger Term Quality

Natural phrases users would say are present — "run happy path tests", "test the UI flows", "QA the happy path", "verify the user journey", "when a test plan defines UI flows" — giving good coverage. It falls short of the 5 anchor because common synonyms like "end-to-end tests", "e2e", "smoke test", or "regression test" are missing, though it clearly exceeds the 3 anchor ('some relevant keywords but missing common variations') since several natural phrasings are included.

4 / 5

Distinctiveness Conflict Risk

The happy-path framing ("core positive flows", "QA the happy path", Playwright UI automation) carves a clear niche distinct from generic testing skills. It is not a 5 because the broader triggers "test the UI flows" and "verify the user journey" are somewhat generic and could overlap with adjacent UI-testing skills (e.g., error-path or regression testing), matching the 4 anchor 'mostly distinct; minor overlap risk'.

4 / 5

Total

18

/

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

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

ravnhq/ai-toolkit

Path

.claude-plugin/plugins/qa-happy-path/skills/qa-happy-path/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.