CtrlK
BlogDocsLog inGet started
Tessl Logo

workspace-guide

Workspace guide to introduce OpenWork and onboard new users.

48

Quality

51%

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 ./ee/apps/landing/public/.well-known/agent-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 an effective, tight onboarding guide: it branches on audience, gives concrete example prompts, and provides exact setup steps and doc links. Its only real weakness is inherited from the description — the frontmatter gives Claude no signal for when this skill should activate — plus a slightly vague closing instruction.

DimensionReasoningScore

Conciseness

The body is lean and well-budgeted: exact prompts to try, a numbered setup path, and terse doc links, with no explanation of concepts Claude already knows. It falls short of anchor 5 only due to minor conversational padding ("Hi, I'm Ben and this is OpenWork").

4 / 5

Actionability

Concrete, executable guidance throughout: the exact question to ask ("Are you more technical or non-technical?"), copy-ready example prompts, numbered install steps, and specific doc URLs. It is not anchor 5 because "End with two friendly next actions" is directive without providing example actions.

4 / 5

Workflow Clarity

A clear branched sequence: ask the audience question, tailor explanation by branch, give the technical path (install → configure providers → start session), then close with next actions. No validation checkpoints are needed since nothing destructive or batch-oriented is performed, matching anchor 4 rather than 5 due to the implicit (not explicit) handling of the non-technical closing path.

4 / 5

Progressive Disclosure

The skill is under 50 lines, has no need for external reference files (none exist in references/, scripts/, or assets/), and is organized into clear sections (audience branches, skills/plugins, MCP, config). Per the rubric guideline this matches anchor 5 for simple skills with well-organized sections.

5 / 5

Total

17

/

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 concise and third-person but overly vague: it names the domain without any concrete capabilities, trigger phrases, or a "use when" clause. It reads like a title rather than a triggerable description.

Suggestions

Add concrete capabilities to the description, e.g. "Introduces the OpenWork workspace, explains skills, plugins, and MCP servers, and tailors onboarding to technical and non-technical users."

Add an explicit "Use when..." clause, e.g. "Use when a new user opens the OpenWork workspace for the first time or asks what OpenWork is."

Include natural trigger terms users would say, such as "what is OpenWork", "getting started", "workspace tour", or "OpenCode setup".

DimensionReasoningScore

Specificity

"introduce OpenWork and onboard new users" names the domain (workspace onboarding guide) but the actions are generic with no concrete capabilities listed. It falls at anchor 2 rather than 3 because no specific action (e.g., 'summarizes files', 'explains skills and plugins') appears in the description itself.

2 / 5

Completeness

It has a vague 'what' ("Workspace guide to introduce OpenWork and onboard new users") and no 'when'/"Use when..." clause at all, matching anchor 2 exactly. The missing-use-when cap of 3 is satisfied.

2 / 5

Trigger Term Quality

The only keywords are generic ('workspace', 'guide', 'onboard', 'new users'); no natural phrases a user would actually say when they need this skill. It is above anchor 1 (domain terms exist) but below anchor 3 (no relevant capability keywords or their common variations).

2 / 5

Distinctiveness Conflict Risk

"Workspace guide" is very broad and would overlap with virtually any workspace-orientation or onboarding skill, matching anchor 2. It does not reach anchor 3 because nothing in the description restricts it to OpenWork-specific triggers a user would say.

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
different-ai/openwork
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.