CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

recipe-front-adjust

Adjust an already-implemented UI in-session with verification against the design source

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./dev-workflows-frontend/skills/recipe-front-adjust/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 well-gated, highly actionable orchestration workflow: explicit sequencing, validation stops, quality routing with feedback loops, and concrete subagent and commit specifications. Its main cost is token overhead from redundant meta-framing sections. Tightening the preamble, identity quote, and scope-boundary duplication would raise conciseness without sacrificing actionability.

Suggestions

Delete the "Core Identity" quote and "Explicit User Instruction" preamble; persona framing adds tokens without changing behavior.

Merge the Scope Boundaries section into the Execution Protocol or Workflow Overview, since it currently restates the same steps a third time.

Collapse Step 5's four repeated "Execute Skill ... before planning or applying adjustment edits" lines into a single prerequisite list.

DimensionReasoningScore

Conciseness

The step content is lean and never explains concepts Claude already knows, but several padded meta sections exist: the "Core Identity" quote, the "Explicit User Instruction" preamble, a Scope Boundaries list that restates the Execution Protocol, and four near-identical "Execute Skill ... before planning or applying adjustment edits" lines in Step 5. Matches anchor 3 ("mostly efficient but ... could be tightened"); not 2 because the verbosity is concentrated in a few removable sections rather than pervasive padding.

3 / 5

Actionability

Guidance is largely executable for an instruction-only skill: an exact subagent invocation with per-parameter spec (`subagent_type: "dev-workflows-frontend:quality-fixer-frontend"`, `direct_scope`, `governing_sources`, `observable_verification`), an exact escalation message for the 0-files case, exact commit trailers (`Verification-Limitation: <reason>` / `Verification-Affected: <affected check or command>`), and a concrete output template. Not 5 because Step 5's verification mechanics ("compare rendering, interaction or tokens") and Step 2's "smallest sufficient repository evidence" remain abstract and defer to external skills.

4 / 5

Workflow Clarity

Steps 1-7 are explicitly ordered with an overview diagram, hard gates ("Stop at every `[Stop: ...]` marker", the Step 3 escalation stop, the Step 4 `[STOP]` for user confirmation), a quality feedback loop (`stub_detected` returns to Step 5), retained-limitation retry logic after commit, and a Completion Criteria checklist. Matches anchor 5 (clear sequence, explicit validation steps, feedback loops, checklists).

5 / 5

Progressive Disclosure

No bundle files exist; all content lives in one well-sectioned file with clear headers (Execution Pattern, Workflow Overview, Steps 1-7, Completion Criteria, Output Example) and clearly signaled one-level pointers to other skills ("Execute Skill: ai-development-guide and read its `references/frontend.md`"). Matches anchor 4; not 5 because at ~145 lines (above the under-50-line exception) content such as the quality-fixer-frontend invocation spec or the Step 7 continuation/trailer rules could be split into a reference file.

4 / 5

Total

16

/

20

Passed

Description

53%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 states a clear, distinctive "what" in concise, fluff-free language, but it omits any "when to use" guidance, which caps completeness, and lists only two of the skill's actual actions. Adding an explicit trigger clause with natural synonyms would lift its weakest dimensions.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to tweak, restyle, or fix an already-built UI feature and a design source (mockup, spec, or screenshot) exists."

Name the remaining concrete actions (edit affected files, verify rendering/tokens against the design source, run typecheck/lint/test, commit) so the description covers the skill's full scope.

Include natural user phrasings such as "tweak", "modify", "restyle", and "frontend" as trigger synonyms.

DimensionReasoningScore

Specificity

"Adjust an already-implemented UI" and "verification against the design source" name the domain plus two concrete actions, but the edit-refine loop, quality checks, and commit that the body covers are absent. Matches anchor 3 ("names domain and 1-2 concrete actions, but not comprehensive"); not 4 because it does not list several specific actions.

3 / 5

Completeness

The "what" is clear ("Adjust an already-implemented UI ... with verification against the design source"), but there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the "when" is entirely absent rather than present but imprecise.

3 / 5

Trigger Term Quality

"Adjust" and "UI" are terms a user might naturally say, but common phrasings like "tweak", "modify", "restyle", "fix", or "frontend" are missing. Matches anchor 3 ("some relevant keywords but missing common variations or synonyms"); not 4 because coverage is thin rather than missing only a few natural terms.

3 / 5

Distinctiveness Conflict Risk

"already-implemented" and "verification against the design source" carve a niche clearly separate from a from-scratch frontend design skill, leaving only minor overlap risk with closely related frontend/design skills. Not 3 because these qualifiers make it more specific than "works with UI"; not 5 because without trigger phrases, general UI-change requests could still match sibling skills.

4 / 5

Total

13

/

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: 2 missing

Warning

Total

15

/

16

Passed

Repository

shinpr/claude-code-workflows

Path

dev-workflows-frontend/skills/recipe-front-adjust/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.