CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

workspace-guide

Workspace guide to introduce OpenWork and onboard new users.

Quality

71%

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 ./.opencode/skills/workspace-guide/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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-structured, lean onboarding script with concrete branching guidance for both technical and non-technical users. Its only notable weakness is the vague closing instruction, which leaves the agent to invent the final next actions.

Suggestions

Replace "End with two friendly next actions to try in OpenWork" with the two concrete suggestions to offer (e.g. summarize a workspace file, or create a weekly checklist), so the closing step is fully specified.

Fix the escaped apostrophes (I\'m, you\'re) in the quoted prompts so the suggested messages are copy-paste ready.

DimensionReasoningScore

Conciseness

At roughly 45 lines the body is lean and every section serves the onboarding purpose, explaining only what Claude would not know (what OpenWork is). Minor conversational padding ("so you don't have to") keeps it just short of the lean-and-efficient level 5 anchor.

4 / 5

Actionability

Guidance is mostly executable: an exact quoted question for the question tool, ready-to-say try-phrases ("Summarize the files in this workspace."), and a numbered setup sequence with specific URLs. The main gap is that "End with two friendly next actions to try in OpenWork" names no actual actions, so it does not reach fully copy-paste-ready level 5.

4 / 5

Workflow Clarity

The flow is clearly sequenced: ask the audience question, branch into non-technical or technical paths, give a numbered install sequence for the technical path, then close. This is a non-destructive conversational skill so no validation cap applies; it falls short of level 5 only because the closing step is a directive without an explicit sequence of what to say.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references (the outbound doc links are one-level-deep pointers, not nested skill content), and is organized into clear per-audience sections. Per the rubric's simple-skill guideline, this earns a 5 with well-organized sections alone.

5 / 5

Total

17

/

20

Passed

Description

48%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 correctly identifies its niche by naming OpenWork and onboarding, but it reads as a label rather than a trigger. It lacks a 'Use when...' clause, lists no concrete capabilities, and misses the natural phrases users would say when they need this skill.

Suggestions

Add an explicit trigger clause, e.g. "Use when a new user first opens the workspace, asks what OpenWork is, or wants help getting started."

Replace the generic verbs with concrete capabilities, e.g. "Introduces OpenWork to new users, explains skills, plugins, and MCP servers, and walks through provider setup."

Include natural user phrases such as "getting started", "welcome", and "what is OpenWork" so the description matches how users actually ask for onboarding help.

DimensionReasoningScore

Specificity

"Workspace guide to introduce OpenWork and onboard new users" names the domain but the only actions are the generic verbs "introduce" and "onboard" — no concrete capability is listed. It matches the anchor 'Names the domain but actions are minimal or generic' and falls short of level 3, which requires 1-2 concrete named actions.

2 / 5

Completeness

There is a recognizable 'what' ("introduce OpenWork and onboard new users") but no 'when' — no "Use when..." clause or equivalent trigger guidance, which per the rubric caps completeness at 3. Level 4 requires both what and an explicit when.

3 / 5

Trigger Term Quality

Keywords like "Workspace guide", "OpenWork", and "onboard new users" are relevant, but the natural phrases a user would actually say ("getting started", "what is OpenWork", "welcome") are missing. Not level 4 because coverage of natural variations is thin; not level 2 because naming the product itself is a real, specific trigger.

3 / 5

Distinctiveness Conflict Risk

Explicitly naming "OpenWork" gives the description a mostly distinct identity with only minor overlap risk against generic workspace/orientation skills. Not level 5 because "Workspace guide" alone is generic and the weak trigger guidance leaves some ambiguity about when it applies.

4 / 5

Total

12

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Mirxa27/arabclue

Path

.opencode/skills/workspace-guide/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.