device-guidance-v1-0-1

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

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./docs/recruit-nextgen/06-add-skills/assets/device-guidance-v1-0-1/SKILL.md

Quality

Content

86%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, highly actionable conversational workflow with exact quoted messages and a precise presentation format. It is concise and well-organized, with only minor room to tighten phrasing.

Dimension	Reasoning	Score
Conciseness	The body is efficient and assumes Claude's competence, with only minor instances of over-explanation (e.g. 'so the table remains easy to scan') that could be trimmed.	4 / 5
Actionability	Fully executable instruction-only guidance: exact table columns, the A/B/C/D letter-to-SharePoint-Item-ID mapping rule, image rendering rules, and quoted fallback messages cover the common cases copy-paste ready.	5 / 5
Workflow Clarity	Steps are clearly sequenced (Clarify, Look up, Present, Unavailable branch, Confirm) with valid/invalid-option handling, but there is no explicit re-validation checkpoint after a selection before acting.	4 / 5
Progressive Disclosure	With no bundle files needed and a well-organized sectioned body under 50 lines, the simple-skill exception applies and the single-level structure is easy to navigate.	5 / 5
	Total	18 / 20 Passed

Description

53%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 clear and specific about its narrow purpose but lacks any explicit trigger guidance and only names a single action. It is distinct yet under-specified on when to invoke it.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g. 'Use when an employee asks about finding, selecting, or requesting a device.'

Broaden the action list beyond 'identify available device options' to cover presenting options and confirming a request.

Include natural trigger synonyms users actually say (laptop, desktop, device request, catalog).

Dimension	Reasoning	Score
Specificity	Names the domain (employee device options) and one concrete action ("identify available device options") plus the source tool, but offers only a single action rather than comprehensive coverage.	3 / 5
Completeness	It clearly states what the skill does, but there is no "Use when..." clause or equivalent explicit trigger guidance, capping completeness at 3 per the rubric guidelines.	3 / 5
Trigger Term Quality	"device options" and "device" are relevant keywords, but common natural phrasings a user would say ("request a device", "get a new laptop", "device catalog") are absent even though the body uses them.	3 / 5
Distinctiveness Conflict Risk	The employee-device-catalog niche tied to the specific `Get Employee Assets` tool is mostly distinct, with only minor overlap risk against a generic IT-help skill.	4 / 5
	Total	13 / 20 Passed

Validation

100%

Warnings & errors only

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: microsoft/agent-academy
Path: docs/recruit-nextgen/06-add-skills/assets/device-guidance-v1-0-1/SKILL.md
Commit: c219c25

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.