device-guidance-v1-0-4

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/07-automate-with-workflows/assets/device-guidance-v1-0-4/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 content is highly actionable and well-structured, with concrete tool/parameter mappings, copy-paste message templates, and clear confirmation-gated sequencing. Minor conciseness gains are available by deduplicating the fallback and Item-ID instructions.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence without explaining basic concepts, but restates the User.DisplayName fallback logic and the 'do not display the SharePoint Item ID' instruction twice, which could be trimmed.	4 / 5
Actionability	Provides fully executable guidance for an instruction-only skill: exact tool names, exact parameter names (requestorName, sharepointItemId, additionalComment), exact OData internal column names (field_1...field_5), copy-paste-ready message templates, and exact fallback values covering the common cases.	5 / 5
Workflow Clarity	A clear sequenced flow with explicit confirmation gates at each decision point and a success checkpoint (workflow returns ModelValue), but it lacks an explicit error-recovery loop for email-tool failure beyond a brief mention.	4 / 5
Progressive Disclosure	A self-contained, single-purpose body of roughly 50 lines with no need for external references, organized under a clear H1 and a labeled Steps section, which the simple-skills note permits to score 5.	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 reasonably distinct, naming a concrete tool and domain, but it lacks an explicit 'Use when...' trigger clause and offers only one concrete action with limited natural keyword coverage.

Suggestions

Add an explicit trigger clause, e.g., 'Use when an employee asks about finding, selecting, or requesting a device.'

Broaden natural trigger terms to include user-facing phrasing like 'request a device', 'available devices', or 'pick a laptop'.

List one or two more concrete actions (e.g., presenting options, submitting a request email) to raise specificity.

Dimension	Reasoning	Score
Specificity	Names the domain (employee device options) and references a concrete tool (`Get Employee Assets`), but only describes one action ('identify available device options'), matching the anchor for domain plus 1-2 concrete actions without comprehensive coverage.	3 / 5
Completeness	Provides a clear 'what' (identify device options for employees via the named tool) but includes no 'Use when...' or equivalent trigger clause, which per the rubric caps completeness at 3.	3 / 5
Trigger Term Quality	Contains a few relevant terms ('device options', 'needs', 'device') but lacks common natural variations a user would say (e.g., 'request a device', 'what devices are available', 'pick a laptop'), fitting the 'some relevant keywords but missing synonyms' anchor.	3 / 5
Distinctiveness Conflict Risk	Scoped to employee device selection via a named tool, giving it a clear niche with only minor overlap risk against general IT/asset skills; not a 5 because the trigger terms are not comprehensive.	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/07-automate-with-workflows/assets/device-guidance-v1-0-4/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.