CtrlK
BlogDocsLog inGet started
Tessl Logo

devtools-ux-writing-refactor

Refactor user-facing UIStrings and localization comments in a DevTools module folder according to UX writing guidelines (child task of b/40799900). Use when simplifying wording, checking sentence case, or improving L10n comments in UIStrings for a specific folder or issue. Don’t use for general code changes or non-UIStrings files.

69

Quality

87%

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

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

An excellent, highly actionable workflow document with concrete commands, project-specific rules, validation checkpoints, and feedback loops. Its weaknesses are inlined reference material with no bundle-file separation and some duplicated rules that add tokens without adding information.

Suggestions

Move the detailed 8-point checklist (especially the extended casing examples in item 5 and the repeated @description casing rules in item 8) into a references/ file (e.g. references/ux-writing-checklist.md) and keep a condensed checklist in SKILL.md, one level deep and clearly signaled.

Deduplicate the panel-casing/@description-casing rules, which appear in both checklist items 5 and 8, and replace section 5's restated critique bullets with a pointer to the checklist to cut repeated tokens.

Replace or supplement the fragile internal path `google3/experimental/users/rachelandrew/tools/chrome_writing/knowledge/style/` with a stable location or inline the applicable rules, since an experimental user directory is likely to move or disappear.

DimensionReasoningScore

Conciseness

Nearly all of the ~140 lines encode DevTools-specific conventions Claude would not know (the `git new-branch` rule, panel-casing rules, `UIStringsNotTranslate` exclusions, `git cl upload -f` rationale), so tokens mostly earn their place. Not score 5 because there is real duplication: the @description casing rule appears in both checklist item 5 and item 8, and section 5's subagent bullets restate the 8-point checklist; not score 3 because the padding is minor rather than whole unnecessary explanations.

4 / 5

Actionability

Guidance is fully executable: copy-paste bash blocks for setup, branching, lint (`npm run lint -- <folder_path>`), tests, and presubmit; a concrete word-replacement map (`preserve` -> `keep`); explicit before/after examples for descriptions (`Tooltip text for the clear button in the profiles sidebar of the Memory panel.`); and a complete `git cl upload` command with the commit description template. Not score 4 because there are no pseudocode or missing key details; placeholders like `<folder_path>` and `<issue_number>` are natural parameters, not gaps.

5 / 5

Workflow Clarity

The eight numbered sections form a clear sequence from pre-flight issue check through refactor, critique, confirmation, and verification, with explicit validation checkpoints (lint, full `npm run test`, presubmit) and a genuine feedback loop (subagent critique repeated until approved, plus 'address feedback and pause again'). This matches the top anchor: clear sequence, explicit validation, feedback loops, and a checklist for the complex process.

5 / 5

Progressive Disclosure

There are no bundle files (no references/, scripts/, or assets/), so all guidance is inlined in a single ~140-line SKILL.md; the detailed casing examples in item 5 and the full 8-point checklist are reference-style material that could live in a separate file, and the only pointers are to an external URL and an internal google3 path rather than well-signaled one-level-deep bundle references. Not score 4 because content that should be separate is inline with no navigational references; not score 2 because the document is well-sectioned with clear headers rather than an unstructured dump.

3 / 5

Total

17

/

20

Passed

Description

82%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, well-scoped description that clearly states what the skill does, when to use it with natural trigger phrases, and when not to use it. The main gap is that the capability statement covers only one-to-two actions rather than the fuller range of the refactoring work.

DimensionReasoningScore

Specificity

The description names its domain ("DevTools module folder", "UIStrings") and one-to-two concrete actions ("Refactor user-facing UIStrings and localization comments"), but stops short of listing several specific actions like the checklist's simplification, casing, or punctuation work. Not score 4 because it doesn't enumerate multiple specific actions; not score 2 because the actions given are concrete rather than generic.

3 / 5

Completeness

It explicitly answers both: "Refactor user-facing UIStrings and localization comments in a DevTools module folder according to UX writing guidelines" (what) and "Use when simplifying wording, checking sentence case, or improving L10n comments in UIStrings for a specific folder or issue" (when), with concrete trigger phrases and an explicit negative boundary ("Don't use for general code changes or non-UIStrings files"). Score 4 would require a weaker 'when' clause, which is not the case here.

5 / 5

Trigger Term Quality

Triggers like "simplifying wording", "checking sentence case", and "improving L10n comments in UIStrings" are phrases a user on this task would naturally say, plus the scoping terms "folder" and "issue". Not score 5 because common variations such as "UX writing", "DevTools strings", or "localization" are absent from the trigger clause; not score 3 because coverage goes beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

The niche is narrow (DevTools UIStrings/L10n comments under a specific tracking bug) and the explicit exclusion "Don't use for general code changes or non-UIStrings files" prevents overlap with general refactoring or code-review skills. Score 4 would apply if there were residual overlap with closely related skills, but the domain-specific artifacts (UIStrings, L10n comments) make conflicts unlikely.

5 / 5

Total

17

/

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