CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

devtools-verification

MANDATORY: Activate this skill ANY TIME you need to build the project, run tests, or verify code health in DevTools. You MUST use this skill before executing commands like ./dt test, ./dt build, autoninja, or linters (never run these through npm or npx), as it contains critical, repository-specific instructions on how to correctly format these commands, filter test runs, and interpret failures.

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

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

A lean, highly actionable skill body whose commands are copy-paste ready and well organized into focused sections, with no bundle-file overhead. Its main weakness is the batch golden-application workflow lacking an explicit validation checkpoint, which caps workflow clarity.

Suggestions

Add an explicit validation step after --apply-goldens (e.g., verify the applied goldens with 'git cl presubmit -u' or re-fetch the failing tests to confirm expected/actual now match) to close the batch-operation validation gap.

Convert the Best practices bullets into an ordered end-of-change checklist (edit → ./dt test → autoninja -C out/Default → ./dt lint → git cl presubmit -u) with an explicit fix-and-retry loop when tests or the build fail.

Trim generic advice Claude already knows ('Run tests often to verify your changes', 'Periodically build to check for errors') and keep only the repo-specific presubmit guidance in Best practices.

DimensionReasoningScore

Conciseness

The body is efficient and repo-specific ('./dt <script> [args]', 'Test files are usually defined alongside their implementation'), with only minor over-explanation in Best practices ('Run tests often to verify your changes', 'Periodically build to check for errors') that Claude already knows and could be trimmed — matching anchor 4 rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

Fully executable, copy-paste-ready commands cover every common case: './dt test <FILEPATH>' with a concrete directory example ('./dt test front_end/models/trace'), 'autoninja -C out/Default', './dt lint <PATH>', and three complete get_cl_test_results.py invocations with flags (--cl, --output-dir, --test-filter, --apply-goldens). This matches anchor 5; there are no gaps versus the anchor-4 example.

5 / 5

Workflow Clarity

Per-task sequences are clear and the dev loop has some checkpoints ('Run tests often', 'git cl presubmit -u at the end of your code changes'), but the batch '--apply-goldens' operation ('apply Linux actual_image screenshot artifacts directly to test/goldens/linux/...') has no explicit post-apply validation step. Per the judging guideline, a batch operation without validation caps workflow clarity at 3, matching anchor 3's 'sequence present but checkpoints missing or implicit' rather than anchor 4.

3 / 5

Progressive Disclosure

The body is 46 lines (under 50) with no bundle files and no need for external references, and is well-organized into focused sections (Running scripts, Testing, Building & compiling, Linting, Fetching Tryjob Results, Screenshot Golden & Inspection Rules, Best practices). The rubric's simple-skill exception allows a 5 with just well-organized sections, which this clearly satisfies.

5 / 5

Total

17

/

20

Passed

Description

78%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, trigger-rich description with an explicit what/when structure and concrete command names, though written in second person with imperative 'MANDATORY/You MUST' framing that costs it specificity under the rubric. Coverage of the body's capabilities is good but omits the tryjob-results and screenshot-golden workflow.

Suggestions

Rewrite in third person (e.g., 'Contains repository-specific instructions for running tests, builds, and linters in DevTools via ./dt and autoninja. Use before executing any test, build, or lint command.') to remove the second-person voice ('You MUST use this skill').

Extend the capability list to mention fetching tryjob results, failure logs, and screenshot goldens via scripts/tools/get_cl_test_results.py, which the description currently omits.

Add natural trigger synonyms such as 'compile', 'presubmit', or 'check the build' to broaden keyword coverage beyond the current build/test/lint terms.

DimensionReasoningScore

Specificity

The description lists several concrete actions ('build the project, run tests, or verify code health', 'correctly format these commands, filter test runs, and interpret failures') with named commands, which fits the anchor-4 'several specific actions; minor gaps' (tryjob fetching and screenshot goldens from the body are unmentioned) rather than anchor 5. However, it is written in second person ('You MUST use this skill', 'ANY TIME you need'), which the judging guidelines penalize by reducing specificity by 1, yielding 3.

3 / 5

Completeness

It explicitly answers both 'what' ('contains critical, repository-specific instructions on how to correctly format these commands, filter test runs, and interpret failures') and 'when' with concrete trigger phrases ('ANY TIME you need to build the project, run tests, or verify code health in DevTools' and 'before executing commands like ./dt test, ./dt build, autoninja, or linters'), matching the anchor-5 example. The anchor-4 caveat ('when could be more explicit') does not apply since the when-clause is highly explicit.

5 / 5

Trigger Term Quality

Good keyword coverage of natural phrases users would say ('build the project', 'run tests', 'verify code health') plus repo-specific tool names ('./dt test', './dt build', 'autoninja', 'linters'), matching anchor 4's 'good keyword coverage; a few natural terms missing' (e.g., 'compile', 'presubmit', 'check the build'). Not 5 because it lacks comprehensive synonym/variation coverage.

4 / 5

Distinctiveness Conflict Risk

It is pinned to a clear niche ('in DevTools', './dt', 'autoninja', 'never run these through npm or npx') making it mostly distinct, matching anchor 4. Not 5 because the broad trigger 'ANY TIME you need to build the project, run tests' creates minor overlap risk with generic build/test/verification skills; not 3 because the DevTools pinning and repo-specific commands are clearly more distinct than 'somewhat specific'.

4 / 5

Total

16

/

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

referenced_paths_exist

Referenced path issues: 4 missing, 4 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

ChromeDevTools/devtools-frontend

Path

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