CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dx-optimizer

Developer Experience specialist. Improves tooling, setup, and workflows. Use PROACTIVELY when setting up new projects, after team feedback, or when development friction is noticed.

Quality

65%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/dx-optimizer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 a readable, well-sectioned overview with a sensible analysis sequence and a concrete deliverables list, but it delivers direction rather than executable guidance: the opening use/don't-use boilerplate is circular filler, the workflow steps lack validation checkpoints, and its only reference points to a nonexistent file. It reads as a template skeleton more than an operational skill.

Suggestions

Delete the circular 'Use this skill when / Do not use this skill when / Instructions' boilerplate (lines 9-24) — phrases like 'Working on dx optimizer tasks or workflows' provide zero information and waste context.

Fix or remove the broken 'resources/implementation-playbook.md' reference — either ship the playbook in the bundle and reference its real path (e.g. references/implementation-playbook.md) or drop the pointer.

Add executable substance to the analysis process: example git-hook configs, a sample .claude/commands/ file, and explicit validation checkpoints (e.g. 'time the onboarding step before and after; only keep changes that measurably reduce it').

DimensionReasoningScore

Conciseness

The core body (optimization areas, deliverables, metrics) is lean bullet-style writing, but roughly the first 18 lines are padded boilerplate: 'Working on dx optimizer tasks or workflows' and 'Needing guidance, best practices, or checklists for dx optimizer' are circular statements that add no information, and 'Clarify goals... Apply relevant best practices' is generic filler. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation'); it is not 2 because the substantive sections are tight, not verbose explanations of known concepts.

3 / 5

Actionability

As an instruction-only skill, code absence is not itself penalized, and there are concrete touches ('Simplify onboarding to < 5 minutes', 'Set up git hooks for common checks', deliverables like '.claude/commands/ additions' and 'Improved package.json scripts'). However, most guidance stops at naming the task — no example commands, hook configurations, or command stubs — leaving it incomplete, which matches anchor 3 rather than 4's 'mostly executable guidance'.

3 / 5

Workflow Clarity

The 'Analysis Process' gives a clear 5-step sequence (profile → identify → research → implement → measure), but the steps are high-level and checkpoints are implicit — 'Measure impact and iterate' gestures at a feedback loop without any validation criteria or error-recovery guidance. This matches anchor 3 ('steps listed but validation gaps; checkpoints missing or implicit'), not 4 where most checkpoints are explicit.

3 / 5

Progressive Disclosure

The body is well-organized into clear headed sections and is short enough to remain navigable inline. However, its single external pointer — 'If detailed examples are required, open resources/implementation-playbook.md' — targets a path that does not exist in the bundle (no resources/, references/, scripts/, or assets/ directories are present), so the one level of disclosure it promises is broken. This keeps it at anchor 3 ('structure present but references not reliably usable') rather than 4.

3 / 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 has the right shape — third-person domain statement plus an explicit 'Use when' clause with three concrete trigger conditions — keeping completeness solid. Its weaknesses are generic action language ('tooling, setup, and workflows') and missing the field's most natural vocabulary (DX, onboarding, developer productivity), which limits specificity and distinctiveness.

Suggestions

Replace the generic 'Improves tooling, setup, and workflows' with concrete capabilities drawn from the body, e.g. 'Automates onboarding, configures git hooks and IDE settings, creates .claude/commands and package.json scripts.'

Add natural trigger terms users would actually say — 'onboarding', 'DX', 'developer productivity', 'slow builds' — to improve trigger quality and distinctiveness.

Tighten the 'after team feedback' trigger to something more distinctive (e.g. 'after developers complain about setup or tooling friction') to reduce overlap with generic feedback-discussion contexts.

DimensionReasoningScore

Specificity

The description names the domain ('Developer Experience specialist') and lists action areas ('Improves tooling, setup, and workflows'), but those actions are generic categories rather than concrete capabilities. It sits between anchor 2 ('actions are minimal or generic') and anchor 3 ('1-2 concrete actions'); it is above 2 because it names three action areas, but below 4 because none are concrete like 'configure git hooks' or 'create .claude/commands'.

3 / 5

Completeness

Both parts are present: what ('Improves tooling, setup, and workflows') and an explicit when ('Use PROACTIVELY when setting up new projects, after team feedback, or when development friction is noticed'). It falls short of 5 because the 'what' is high-level and generic compared to the concrete-action examples in the anchor; it is clearly above 3 since the when-clause is explicit with concrete triggers, not merely implied.

4 / 5

Trigger Term Quality

The when-clause provides three natural trigger phrases: 'setting up new projects', 'after team feedback', and 'development friction is noticed'. It is below 5 because common variations users would actually say are missing — 'onboarding', 'DX', 'developer productivity', 'slow builds' — but above 3 because coverage goes beyond a single keyword.

4 / 5

Distinctiveness Conflict Risk

'Developer Experience' names a niche, but the triggers are broad enough to overlap with other skills — 'setting up new projects' collides with project-scaffolding/init skills and 'after team feedback' could fire on any feedback discussion. This matches anchor 3 ('somewhat specific but could still overlap'); it is not 4 because the overlap risks are more than minor.

3 / 5

Total

14

/

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/dx-optimizer/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.