CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

browser-preview

Hub 内嵌浏览器预览 localhost 应用。 Use when: 写前端代码、跑 dev server、需要看页面效果、调 UI、operator说"看看效果"。 Not for: 后端纯 API 开发、不涉及页面的工作。 Output: 前端页面在 Hub browser panel 中实时预览。

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 an exceptionally actionable, well-validated runbook: concrete commands, explicit status/delivery gates, and a thorough error-recovery table. Its weaknesses are token efficiency (significant verbatim duplication of the launcher command and grammar rules) and the absence of any progressive disclosure — everything, including deep contract detail, lives inline in a single file.

Suggestions

Move the managed-launcher command grammar (bounded vs ordinary form, status/stop selection rules) into a references/ file and keep a single canonical copy plus a pointer in SKILL.md; it is currently repeated verbatim and re-explained in three sections (基础流程 step 1, 常见错误, 什么时候主动用).

Deduplicate the dev-server start command — it appears word-for-word in both 基础流程 step 1 and the Step 1 block of 调用步骤 — by referencing one canonical statement of the command.

Fix or inline the `../.cat-cafe-shared-refs/evidence-output-contract.md` reference: it points outside the skill bundle, does not exist in this bundle context, and is only mentioned parenthetically rather than clearly signaled.

DimensionReasoningScore

Conciseness

The body is dense and project-specific with no padding of concepts Claude already knows, but the managed-launcher command is repeated verbatim twice (基础流程 step 1 and Step 1 of the 调用步骤 block) and the bounded-vs-ordinary `--dir` grammar is re-explained in three separate places (step 1, the 常见错误 table, and the 什么时候主动用 list). Mostly efficient but noticeably duplicative and could be tightened, matching anchor 3 rather than 4.

3 / 5

Actionability

Guidance is fully executable: exact `pnpm --dir ... preview:process start/status` commands, a curl probe with expected status codes (200/301/304 vs 000), a concrete `cat_cafe_preview_open({port, path, worktreeId, threadId})` call with a required-parameter table, and a symptom→cause→fix error table. Copy-paste ready commands cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

The 调用步骤 section gives an ordered, non-skippable three-step sequence with explicit validation gates (status=running before proceeding, curl HTTP-code checks, the deliveryStatus decision table where only "applied" justifies reporting success) plus feedback loops (restart the server on proxy error, consult the 常见错误 table). This matches anchor 5's explicit-validation-and-recovery profile.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), yet the skill inlines ~150 lines including a dense managed-launcher contract and delivery semantics that clearly belong in separate reference files. The only file reference, `../.cat-cafe-shared-refs/evidence-output-contract.md`, points outside the skill bundle and is not verifiable/present, matching anchor 3 (content that should be separate is inline, references not clearly signaled) rather than 4.

3 / 5

Total

16

/

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.

The description is well-structured with explicit what/when/not-for/output clauses and natural trigger phrases, scoring near the top of the scale. Its main weakness is capability specificity — it names only the core preview action while the body implements several more (managed process launching, delivery-status verification, screenshots).

DimensionReasoningScore

Specificity

Names the domain clearly ("Hub 内嵌浏览器预览 localhost 应用") and one concrete capability (real-time preview in the Hub browser panel), but does not enumerate the skill's other concrete actions such as managed dev-server launching, status/origin verification, or screenshots. This matches the anchor for 1-2 concrete actions without comprehensive coverage, and falls short of anchor 4 which expects several listed actions.

3 / 5

Completeness

It explicitly answers what ("Hub 内嵌浏览器预览 localhost 应用") and when ("Use when: 写前端代码、跑 dev server、需要看页面效果、调 UI、operator说'看看效果'") with a concrete quoted trigger phrase, and additionally provides a not-for boundary ("后端纯 API 开发") and an output statement. This clearly matches anchor 5 rather than anchor 4, since the when-clause is already explicit and specific.

5 / 5

Trigger Term Quality

The description contains natural phrases a user would actually say ("写前端代码", "跑 dev server", "调 UI", "operator说'看看效果'") plus "localhost", giving good keyword coverage. It misses several natural synonyms (e.g. "preview", "HMR", "看看页面", "浏览器") that only appear in the separate triggers list rather than the description itself, so it does not reach comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (Hub's embedded browser panel for localhost apps) and the explicit "Not for" clause reduces mis-triggering, but broad terms like "跑 dev server" and "localhost" carry minor overlap risk with general dev-server or web-testing skills. Mostly distinct with minor overlap, matching anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

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

Warning

Total

14

/

16

Passed

Repository

zts212653/clowder-ai

Path

cat-cafe-skills/browser-preview/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.