CtrlK
BlogDocsLog inGet started
Tessl Logo

device-guidance-v1-0-1

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-1/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 a well-structured, highly actionable conversational workflow with explicit branching and concrete formatting rules, scoring at the top of the range on actionability, workflow clarity, and progressive disclosure. The only weakness is minor redundancy in the final step that keeps conciseness at the midpoint.

DimensionReasoningScore

Conciseness

The body is mostly lean bullet points without explaining concepts Claude already knows, but the closing instruction repeats itself: 'politely end the conversation and session. Do not continue asking follow-up questions. Do not ask any further questions.' Not a 3 because of that redundancy; not a 1 because there is no conceptual padding.

2 / 3

Actionability

Provides fully concrete guidance: exact table columns, an A/B/C/D option scheme mapped to SharePoint Item IDs, required Key-detail fields (Manufacturer, Color, Purchase Price), and 80-120px image sizing. Not a 2 because nothing is left as vague direction; for an instruction-only skill this is copy-paste ready.

3 / 3

Workflow Clarity

A clear five-step sequence (Clarify -> Look up -> Present -> If unavailable -> Confirm) with an explicit error-recovery branch for unavailable devices and a confirm gate before proceeding. Not a 2 because checkpoints are explicit rather than implicit; the destructive/batch cap does not apply to this conversational flow.

3 / 3

Progressive Disclosure

The skill is under 50 lines with no external references needed and is organized into a well-structured ## Steps section, which per the guidelines earns a 3 for simple skills. Not a 2 because the structure is clean and monolithic text is avoided.

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 states a clear purpose and anchors to a specific tool, but it omits any 'Use when...' trigger clause and uses only generic device terms, limiting its discoverability and distinctiveness. It sits squarely at the midpoint across all dimensions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when an employee asks to find, choose, or request a device such as a laptop, desktop, monitor, or phone.'

Expand trigger terms to cover natural user phrasings like 'request a device', 'available hardware', or 'order a laptop'.

List concrete actions (e.g. 'look up approved models, check availability, and submit a request') to lift specificity from 2 to 3.

DimensionReasoningScore

Specificity

Names the domain ('available device options') and one concrete action ('identify ... based on their needs') anchored to a specific tool, but does not list multiple specific actions. Not a 3 because it stops at a single generic action; not a 1 because it is concrete rather than vague like 'Helps with devices'.

2 / 3

Completeness

Answers 'what' (identify device options) but provides no 'Use when...' trigger guidance, which per the guidelines caps completeness at 2. Not a 1 because the what is clearly stated; not a 3 because the when is entirely missing.

2 / 3

Trigger Term Quality

Includes some relevant natural terms ('device options', 'needs') but misses common variations a user would say ('request a device', 'laptop', 'catalog', 'order hardware'). Not a 3 due to thin coverage; not a 1 because the terms present are user-natural rather than jargon.

2 / 3

Distinctiveness Conflict Risk

Tying the skill to the specific 'Get Employee Assets' tool gives it a niche, but 'device options based on their needs' is generic enough to overlap with broader IT/HR device skills. Not a 3 because triggers are not sharply distinct; not a 1 because the tool anchor narrows the scope.

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.