CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

device-guidance-v1-0-4

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

60

Quality

76%

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-nextgen/07-automate-with-workflows/assets/device-guidance-v1-0-4/SKILL.md
SKILL.md
Quality
Evals
Security

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 tightly written, highly actionable conversational workflow with exact scripts, table formats, OData field mappings, and tool parameters — copy-paste ready for an instruction-only skill. Its only weaknesses are minor duplicated instructions and an under-specified failure path for the email submission step.

DimensionReasoningScore

Conciseness

The body is dense, purely operational instruction with no concept explanations — every line tells Claude what to do. Minor duplication (the User.DisplayName/User.Email fallback is stated in both the "Get User's display name" and "Pass request details" steps, and "end the conversation... do not continue asking follow-up questions" appears in two steps) keeps it below a 5.

4 / 5

Actionability

Fully executable guidance: exact quoted messages to send, a concrete table format with column definitions, a copy-paste-ready OData example ("$filter=field_4 eq 'Laptop' and field_2 eq 'Dell'"), exact tool parameter names (requestorName, sharepointItemId, additionalComment), and a defined fallback value ("No additional requirements provided").

5 / 5

Workflow Clarity

A clear, well-sequenced conversation flow with explicit user-confirmation checkpoints before proceeding ("Only after the user explicitly approves the completed request summary"). It falls short of 5 only because failure handling is a bare mention ("unless the workflow fails or required information is missing") with no recovery steps or feedback loop for a failed submission.

4 / 5

Progressive Disclosure

A single-purpose, ~50-line skill with no bundle files and no need for external references; per the scoring notes, this can score 5 with well-organized sections, which it has (a single "Steps" section with clearly labeled, ordered sub-steps).

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 names a concrete capability and a specific tool, giving it a clear niche, but it describes only the lookup step and entirely lacks a "when to use" trigger clause and natural user vocabulary (laptop, request a device, etc.). Adding an explicit "Use when..." clause with common user phrasings would raise completeness and trigger term quality.

Suggestions

Add an explicit trigger clause, e.g. "Use when an employee asks about finding, selecting, or requesting a device such as a laptop, desktop, mobile device, or peripheral".

Include natural synonyms users would actually say — laptop, desktop, monitor, keyboard, request a device, device availability — to improve trigger term coverage.

Briefly enumerate the full capability set (look up approved options, present them, submit the request) rather than only the initial identify step.

DimensionReasoningScore

Specificity

"Helps employees identify available device options based on their needs, using the `Get Employee Assets` tool" names the domain and one concrete action plus the specific tool, similar to "Processes PDF files and extracts content". It does not list the several specific actions (presenting options in a table, submitting the request email) that would justify a 4.

3 / 5

Completeness

The "what" is reasonably clear (identify device options via the Get Employee Assets tool), but there is no "Use when..." clause or equivalent trigger guidance anywhere; per the judging guidelines, a missing when-clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords like "device", "device options", and "employees" are present, but common natural variations users would say — "laptop", "monitor", "request a device", "new hardware" — are missing. This matches "Some relevant keywords but missing common variations or synonyms".

3 / 5

Distinctiveness Conflict Risk

The employee-device niche and the named `Get Employee Assets` tool make it mostly distinct from other skills, with only minor overlap risk with generic IT-support or asset-management skills. It lacks the distinct trigger phrases needed for a 5.

4 / 5

Total

13

/

20

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.

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

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.