CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

devtools-testing-guidance

Guidance on selecting the appropriate test suite (Unit, API, or E2E tests) when writing new tests in Chrome DevTools. MUST be used when writing new tests.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 is an exemplary lean decision guide: it assumes Claude's competence, supplies only repo-specific facts (import sources, file locations, BUILD.gn targets), states an explicit default rule, and cleanly delegates verification concerns to a sibling skill. The only meaningful gap is the absence of a minimal complete test-file example to make the per-suite conventions fully copy-paste ready.

DimensionReasoningScore

Conciseness

Roughly 50 lean lines where nearly every statement is repo-specific knowledge Claude cannot already have (import sources, BUILD.gn targets, file naming conventions). There is no padding or explanation of known concepts; the few definitional lines ("Use unit tests for isolated testing of…") double as the default-choice decision rule, so every token earns its place.

5 / 5

Actionability

Concrete and executable throughout: exact import paths ("import {describe, it} from '../conductor/mocha-interface.js'"), exact locations ("front_end/ with .test.api.ts extension", "test/e2e/"), and exact BUILD targets ("devtools_api_test_module("api_tests")"). Minor gaps keep it below anchor 5: no complete sample test file, no rule for choosing between devtools_ui_module and devtests_foundation_module, and the E2E BUILD.gn sentence is convoluted.

4 / 5

Workflow Clarity

The decision workflow is unambiguous: an explicit default ("The vast majority of tests in DevTools should be unit tests") with clear escalation signals for API and E2E, and a consistent per-suite structure (When to use / Location / Test functions / BUILD.gn). Verification (running tests, linters) is explicitly delegated to the devtools-verification skill via the NOTE, and no destructive/batch cap applies.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external bundle files (none exist, and none are needed), and the content is well organized into three clearly parallel suite sections with a clearly signaled cross-skill pointer. Under the simple-skill guideline this matches anchor 5.

5 / 5

Total

19

/

20

Passed

Description

70%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 is a solid, third-person statement with an explicit MUST-use trigger clause, a clear domain, and good natural keywords. Its main weakness is limited action breadth — it describes one selection action rather than enumerating what the guidance covers (locations, imports, BUILD targets) — and a single trigger phrasing without synonyms.

Suggestions

Enumerate the concrete actions the guidance provides, e.g. "Guidance on selecting the appropriate test suite (Unit, API, or E2E) for new tests in Chrome DevTools, covering file location, test-function imports, and BUILD.gn target registration for each suite."

Broaden trigger phrasing with natural variations, e.g. "Use when writing, adding, or updating tests — including unit, API, or E2E tests — in Chrome DevTools."

Add a distinguishing clause against the sibling skill, e.g. "For how to run tests or execute linters, use devtools-verification instead," to reduce overlap risk with that closely related skill.

DimensionReasoningScore

Specificity

"Guidance on selecting the appropriate test suite (Unit, API, or E2E tests)" names the domain and one concrete action with the three suite types enumerated, but it does not list several distinct actions. It clearly exceeds anchor 2 (the action is concrete, not generic) but falls short of anchor 4, which requires a list of several specific actions.

3 / 5

Completeness

Both parts are explicitly present: a clear what ("Guidance on selecting the appropriate test suite (Unit, API, or E2E tests) when writing new tests in Chrome DevTools") and an explicit when ("MUST be used when writing new tests"). Not anchor 5 because the trigger rests on a single phrasing without the multiple concrete trigger variations of the 5 example, though it is well above the weak/missing-when case of anchor 3.

4 / 5

Trigger Term Quality

Natural phrases like "writing new tests", "test suite", and "Unit, API, or E2E tests" give good keyword coverage, and enumerating all three suite types captures how users name tests. Common variations (e.g. "adding tests", "test coverage") are missing, so it does not reach anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Scoping to "in Chrome DevTools" and to test-suite selection gives a clear niche with a distinct trigger. Minor overlap risk remains with the closely related devtools-verification skill and with the somewhat broad "writing new tests" trigger, so it fits anchor 4 rather than anchor 5's minimal-conflict profile.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

ChromeDevTools/devtools-frontend

Path

.agents/skills/devtools-testing-guidance/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.