CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ce-polish

Polish a working feature through user-directed live browser feedback. Use when a functional feature needs focused UX refinement before shipping.

Quality

88%

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

88%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 exemplary lean overview: a crisp done/boundaries contract plus a five-step workflow with explicit checkpoints, routing all detail to real, well-scoped reference files. The only structural cost is two-level reference chaining, and a couple of steps leave the exact inspection action to judgment.

Suggestions

Make step 4's inspection instruction slightly more concrete (e.g., name the preferred browser tool or what 'in-scope surface' means) so actionability reaches fully executable guidance.

Consider listing the secondary references (dev-server recipes, launch-json-schema, live-remote) in a short navigation block in SKILL.md or flattening the run.md -> recipe chain, so the bundle reads as one level deep.

DimensionReasoningScore

Conciseness

The ~23-line body assumes Claude's competence throughout: no concept explanations, no padding, every sentence carries operational content (e.g., "Read `references/run.md` before resolving the requested ref or starting anything"). Even the dense step-1 disclosure sentence is load-bearing requirement text, not filler, so it matches anchor 5 rather than anchor 4's "minor instances of over-explanation".

5 / 5

Actionability

Steps are concrete and delegating: named files to read ("Read `references/run.md`"), a named sibling skill to invoke ("invoke `ce-commit` for the polish changes"), and specific reporting outputs ("report the commit(s), the still-running server URL, and any residual blocker"). Per the rubric's code-vs-instruction note, absent code is not penalized, but phrases like "inspect only as needed, edit the in-scope surface" and "use a browser capability available in the active harness" leave the exact action to judgment, which is the minor gap that keeps this at anchor 4 instead of 5.

4 / 5

Workflow Clarity

The five-step Run sequence has explicit checkpoints and stop conditions: ask live-or-traditional "once, before any server starts", "Wait for observations. ... Do not start a review pass", the feedback loop of iterate/hot-reload/inspect, and explicit termination criteria in the Done section (every fix reflected or reported as blocked; blocker ends the run with resume evidence). It exceeds anchor 4 because validation and closure conditions are explicit rather than implicit.

5 / 5

Progressive Disclosure

The body is a lean router: it signals exactly which reference owns what ("`references/live-start.md`; it owns preconditions, install, the endpoint, and the URL handoff"; "`references/run.md` ... owns existing-worktree safety, dev-server discovery ..."), and all referenced files exist in the bundle. Scored against the actual bundle, references chain two levels from SKILL.md (run.md routes onward to dev-server-*.md and launch-json-schema.md; live-start.md routes to live-loop.md, live-remote.md, and install-riffrec.md), which is more depth than the anchor-5 "one-level-deep" pattern, so anchor 4 fits.

4 / 5

Total

18

/

20

Passed

Description

83%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 concise, specific description that clearly answers both what the skill does and when to use it, in third person with natural trigger terms. Minor room to broaden trigger vocabulary and surface the live-mode capability for distinctiveness.

DimensionReasoningScore

Specificity

"Polish a working feature through user-directed live browser feedback" names the domain, the concrete action, and the mechanism (live browser feedback), which fully covers this single-purpose skill. It stays at 4 rather than 5 because it does not enumerate several distinct actions (the anchor-5 pattern), and at 4 rather than 3 because the action and mechanism are concrete and comprehensive for the skill's narrow scope rather than generic.

4 / 5

Completeness

Both parts are explicit: the what ("Polish a working feature through user-directed live browser feedback") and the when ("Use when a functional feature needs focused UX refinement before shipping"). The when-clause is a concrete, specific trigger phrase, matching the anchor-5 example structure; anchor 4 would require the when to be less explicit than it is here.

5 / 5

Trigger Term Quality

Natural terms a user would say are present: "polish", "UX refinement", "working feature", "before shipping". A few natural variations are missing (e.g., "UI", "interface", "visual" or "polish the UI" phrasings), which fits anchor 4; it exceeds anchor 3 because the keywords that exist are natural user phrasings, not jargon.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (post-feature UX polish driven by live user feedback) and unlikely to trigger for unrelated skills. It is not 5 because the description does not mention the live voice/draw mode, so a user asking for "polish" could plausibly collide with broader review or UI-improvement skills; it is well above anchor 3's generic overlap.

4 / 5

Total

17

/

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

EveryInc/compound-engineering-plugin

Path

skills/ce-polish/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.