CtrlK
BlogDocsLog inGet started
Tessl Logo

device-guidance-v1-0-2

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

59

Quality

67%

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-2/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

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

The body is highly actionable and well-sequenced with concrete field mappings and an executable filter example; its only weakness is mild verbosity in the image-handling and OData sections that could be condensed.

Suggestions

Consolidate the SharePoint internal column names (field_1..field_5) into a compact lookup table and drop the redundant restatement about never using display names.

Tighten the image-column paragraph into a few terse rules (inline if supported else link; 80-120px thumbnails; no invented URLs; 'No image available' when missing).

DimensionReasoningScore

Conciseness

The body is mostly efficient operational guidance with no concept over-explanation, but the image-handling paragraph and the redundant OData display-name warning could be tightened into a compact lookup table.

2 / 3

Actionability

Guidance is fully concrete and executable: exact table columns, alphabet-option mapping, internal field names (field_1..field_5), a ready-to-use filter example, and precise 80-120px image sizing.

3 / 3

Workflow Clarity

A clearly sequenced conversational workflow (clarify → look up → present → handle unavailability → confirm) with explicit branching and edge-case handling; not a destructive/batch operation so missing validation loops do not cap it.

3 / 3

Progressive Disclosure

This is a simple, single-purpose skill under 50 lines with no external references needed; content is well-organized into clearly labeled steps, which satisfies progressive disclosure per the simple-skills note.

3 / 3

Total

11

/

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 clear and in correct third-person voice, but it states only one action and omits an explicit 'Use when...' trigger with natural user terms, leaving every dimension at the mid-level.

Suggestions

Add a 'Use when...' clause with explicit natural triggers, e.g. 'Use when an employee asks to find, select, or request a device such as a laptop, desktop, monitor, or peripheral.'

List multiple concrete actions (e.g. 'identify available device options, check stock/availability, and guide the request') to raise specificity.

Include common user terms (laptop, desktop, mobile device, monitor, keyboard, request a device) instead of relying on the internal 'Get Employee Assets' tool name.

DimensionReasoningScore

Specificity

The description names the domain ('available device options') and a concrete action ('identify') plus the backing tool, but lists only one action rather than multiple specific concrete actions.

2 / 3

Completeness

It answers 'what' clearly but lacks a 'Use when...' trigger clause, so the 'when' is only implied; per guidelines a missing explicit trigger caps completeness at 2.

2 / 3

Trigger Term Quality

'device options' and 'device' are relevant, but common natural variations a user would say (laptop, desktop, monitor, request a device) are missing, and 'Get Employee Assets' is internal jargon.

2 / 3

Distinctiveness Conflict Risk

Binding to the `Get Employee Assets` tool gives it a niche, but the generic 'device options' trigger could still overlap with other asset/IT skills since no distinct natural triggers are stated.

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.