CtrlK
BlogDocsLog inGet started
Tessl Logo

workspace-navigator

猫猫把“打开文档、代码或日志”等模糊意图解析成本地绝对路径或 worktree 相对路径,并返回 applied、queued、blocked 或 unconfirmed 的真实 Workspace 投递状态。

67

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

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.

The body is a strongly actionable, well-validated workflow: concrete tool calls, per-intent search strategies, explicit pre-call path validation, and per-status feedback loops with a troubleshooting table. Its only weaknesses are localized redundancy around the log shortcut and a long inline receipt-protocol section in a file with no reference files to offload detail.

DimensionReasoningScore

Conciseness

The body is dense and table-driven, assumes competence, and never explains concepts Claude already knows; guidance is given as lookup tables, priorities, and imperative rules. It is not a 5 because there is real redundancy — the log-panel shortcut is explained in the 场景速查表, again in 面板快捷入口(F130), and again in 什么时候主动用 — and the receipt-protocol section is long contractual prose that could be tightened; it is above a 3 because the padding is localized rather than pervasive.

4 / 5

Actionability

Concrete, ready-to-use guidance throughout: exact tool invocations with parameters (cat_cafe_workspace_navigate({ path, action, threadId })), specific glob patterns per intent (glob("docs/features/F131*"), glob("**/*chatStore*")), a parameter table with required/conditional flags, example calls with real-looking paths and line numbers, and a deliveryStatus-to-next-action table. Not below 5: the examples cover the common cases (reveal directory, open file, open to line) and every instruction maps to an executable action.

5 / 5

Workflow Clarity

A clearly sequenced three-step workflow (intent parse → path search → typed MCP call) with an explicit validation rule ("先 glob/grep 确认文件存在,再调 API"), explicit feedback loops for each deliveryStatus (queued → wait for target thread, blocked → clear lock, unconfirmed → verify Hub online and retry), multi-result disambiguation rules, and a troubleshooting table. Not a 4: checkpoints and error-recovery loops are present and explicit, matching the anchor-5 example's structure.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and none are referenced, so there are no nested or buried references; the body is organized into well-labeled sections with tables. It is not a 5 because at ~185 lines it exceeds the simple-skill range where sections alone suffice, and self-contained inline blocks like the revision-bound receipt protocol and the full scenario lookup table are candidates for a one-level-deep reference file; it is above a 3 because structure is clean, navigable, and nothing is misplaced or buried.

4 / 5

Total

18

/

20

Passed

Description

75%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 concrete and well-scoped: it states two specific capabilities with enumerated path formats and delivery states, and the frontmatter's trigger list supplies strong natural-phrase coverage. Its main gaps are the absence of an explicit 'Use when...' usage clause and slightly broad open-ended intent phrasing that leaves minor routing ambiguity with sibling skills.

Suggestions

Add an explicit 'Use when...' clause to the description itself (e.g. "Use when operator asks to open/view files, code, logs, or design docs in the Hub Workspace panel") rather than relying on the triggers list alone.

Mention the Hub Workspace panel and the reveal/open distinction in the description so the niche is unmistakable against sibling skills like browser-preview.

Include a few file-extension and action synonyms in the trigger guidance (.log, .pen, 跳转到, 展开目录) to round out natural-term coverage.

DimensionReasoningScore

Specificity

The description names concrete actions with enumerated specifics — "解析成本地绝对路径或 worktree 相对路径" and "返回 applied、queued、blocked 或 unconfirmed 的真实 Workspace 投递状态" — which is more detailed than the anchor-3 example but covers only two action clauses rather than the several-action coverage of anchor 5. It is not a 3 because the enumerated path formats and four delivery states go well beyond minimal or generic actions; it is not a 5 because it omits capabilities the body documents (reveal vs open actions, directory browsing, search strategy).

4 / 5

Completeness

The 'what' is clear (parse vague intents into concrete paths and report real Workspace delivery status), and the 'when' is addressed by quoting the trigger class "'打开文档、代码或日志'等模糊意图" plus the explicit triggers list in the frontmatter. It is not a 5 because the description lacks a direct 'Use when...' style clause and the when-guidance is embedded as the object of parsing rather than stated as usage guidance; it is above a 3 because trigger phrases are explicit, not merely implied.

4 / 5

Trigger Term Quality

The description itself quotes the natural phrase "打开文档、代码或日志", and the frontmatter carries a dedicated triggers list with a dozen natural user phrases ("打开文件", "看看代码", "看日志", "帮我打开", "一起看看", "打开设计图", "看看 spec") covering good synonym variation. It is not a 5 because coverage lacks file-extension terms (.log, .pen, .md) and a few natural variations (e.g. "跳转到", "在面板里打开"); it is above a 3 because the phrase set is broad and clearly things a user would actually say.

4 / 5

Distinctiveness Conflict Risk

The enumerated delivery states and Workspace path-resolution scope carve a clear niche distinct from sibling skills like browser-preview (localhost pages) per the body's own comparison table. It is not a 5 because the quoted intents "打开文档、代码或日志" are broad enough that a user asking to 'open code' in another context could route here incorrectly; it is above a 3 because the Workspace delivery-status framing is highly specific and unlikely to collide with unrelated skills.

4 / 5

Total

16

/

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.

Validation15 / 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
zts212653/clowder-ai
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.