CtrlK
BlogDocsLog inGet started
Tessl Logo

device-guidance-v1-0-3

Helps employees identify available device options based on their needs, using the `Get Employee Assets` tool.

64

Quality

75%

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 ./docs/recruit-v2-preview/06-add-a-skill/assets/lab-skills/device-guidance-v1-0-3/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a tight, well-structured instruction workflow with concrete field-level detail and explicit validation/fallback checkpoints, hitting the top anchor on every dimension.

DimensionReasoningScore

Conciseness

The body is lean and efficient, explains nothing Claude already knows, and every step earns its place; it is not a 2 because there is no unnecessary explanation or padding to tighten.

3 / 3

Actionability

As an instruction-only skill it gives concrete executable guidance — exact table columns, internal OData field names (field_1..field_5) with a sample filter, and image-thumbnail sizing — which the scoring notes treat as fully actionable even without code.

3 / 3

Workflow Clarity

Steps are clearly sequenced with explicit checkpoints: an unavailable-catalog fallback directing the user to IT, a lettered-option confirmation, capture of additional requirements, and a defined stop condition if the user declines.

3 / 3

Progressive Disclosure

This is a simple sub-50-line single-purpose skill with no need for external references, and its sections are well-organized; per the simple-skills scoring note that warrants the top anchor even without separate bundle files.

3 / 3

Total

12

/

12

Passed

Description

50%

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 accurate and tool-specific but stays at a single-action level and lacks an explicit use-when trigger clause, leaving every dimension at the middle anchor.

Suggestions

Add an explicit "Use when..." trigger clause, e.g. "Use when an employee asks to find, select, or request a device (laptop, desktop, mobile, or peripheral)."

List multiple concrete actions (e.g. "identify available devices, present options with specs and availability, and route a device request") to lift specificity.

Include natural trigger terms users would say — "request a device", "new laptop", "available hardware" — to improve trigger term quality and distinctiveness.

DimensionReasoningScore

Specificity

Names the domain (device options) and one concrete action ("identify available device options") plus the governing tool, but it is a single action rather than the multiple specific concrete actions the top anchor requires.

2 / 3

Completeness

It states what the skill does (identify available device options via the Get Employee Assets tool) but provides no explicit "Use when..." trigger clause; per the judging guidelines a missing trigger clause caps completeness at 2.

2 / 3

Trigger Term Quality

Contains some relevant natural terms ("employees", "device options", "needs") but omits common variations a user would actually say such as "request a device", "new laptop", or "order hardware".

2 / 3

Distinctiveness Conflict Risk

Binding to the specific `Get Employee Assets` tool gives it a clearer niche than a generic description, yet "device options based on their needs" is still broad enough to overlap with general IT/asset-management skills.

2 / 3

Total

8

/

12

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
microsoft/agent-academy
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.