CtrlK
BlogDocsLog inGet started
Tessl Logo

workspace-guide

Workspace guide to introduce OpenWork and onboard new users.

46

Quality

48%

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

71%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, actionable onboarding script with clear branching and concrete examples. Its main weakness is some conversational padding in the intro and a vague closing instruction.

DimensionReasoningScore

Conciseness

The body is mostly efficient with tight bullet examples and numbered steps, but the conversational opener ('Hi, I'm Ben and this is OpenWork. It's an open-source alternative...') and the explanation paragraph add padding Claude does not need, matching the 'mostly efficient but includes some unnecessary explanation' anchor.

3 / 5

Actionability

It provides concrete example prompts ('Summarize the files in this workspace.', 'Create a checklist for my week.'), numbered setup steps, and specific config references (opencode.json, Skills/Plugins tabs, doc links), giving mostly executable guidance with only minor gaps like the vague 'End with two friendly next actions'.

4 / 5

Workflow Clarity

The flow is a clearly sequenced ask-then-branch process: ask technical level via the question tool, route to a tailored branch, then close with next actions; no destructive or batch operations apply so the validation cap does not trigger, but the closing step is underspecified.

4 / 5

Progressive Disclosure

The skill is under 50 lines, has no need for external bundle references, and is organized into clearly labeled sections (non-technical, Skills and plugins, technical), satisfying the simple-skill exception that lets progressive disclosure score 5 on well-organized sections alone.

5 / 5

Total

16

/

20

Passed

Description

25%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 too vague to function as a skill trigger: it states a broad purpose without concrete capabilities, natural trigger terms, or an explicit 'when to use' clause. It is distinguishable only by naming OpenWork, which is insufficient.

Suggestions

Add concrete capabilities, e.g. 'Summarize workspace files, draft checklists, and walk new users through OpenWork setup.'

Append an explicit trigger clause such as 'Use when onboarding a new user to OpenWork or when the user asks how to get started.'

Tighten distinctiveness by naming OpenWork-specific actions (Skills tab, plugins, opencode.json config) rather than generic onboarding language.

DimensionReasoningScore

Specificity

The phrase 'introduce OpenWork and onboard new users' names the domain but relies on generic verbs ('introduce', 'onboard') rather than concrete actions, matching the 'names the domain but actions are minimal or generic' anchor; it falls short of 3 because no specific concrete actions are listed.

2 / 5

Completeness

It gives only a vague 'what' ('workspace guide to introduce... and onboard...') with no 'when' clause at all, matching the 'has a vague what and no when' anchor and staying below the missing-trigger cap of 3.

2 / 5

Trigger Term Quality

There are no natural keywords a user would actually say to invoke this skill and no 'Use when...' trigger phrase; 'onboard' is a weak, purpose-describing term rather than user language, leaving it between the 'no natural keywords' and 'one or two generic keywords' anchors.

2 / 5

Distinctiveness Conflict Risk

Although it names OpenWork, the description is very broad ('workspace guide', 'introduce', 'onboard') and would overlap with general guidance/onboarding skills, matching the 'very broad; high overlap risk' anchor rather than the more specific 3.

2 / 5

Total

8

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Mirxa27/arabclue
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.