troubleshooting-procedure

Call this when a user states an IT issue and requests troubleshooting help. It provides step-by-step procedure for diagnosing and resolving IT issues, including escalation with a ticket summary.

Jump to install

Repository: microsoft/agent-academy
Last source activity: August 12, 2026 at 20:08
Detected SKILL.md language: English
Stars: 3,252
Forks: 197

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/microsoft/agent-academy --skill troubleshooting-procedure

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

device-guidance-v1-0-4

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

2026-08-12

device-guidance-v1-0-1

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

2026-08-12

device-guidance-v1-0-2

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

2026-08-12

View all from this repository

name	troubleshooting-procedure
description	Call this when a user states an IT issue and requests troubleshooting help. It provides step-by-step procedure for diagnosing and resolving IT issues, including escalation with a ticket summary.

IT Troubleshooting Procedure

Follow this procedure when an employee reports a technical issue.

Clarify the issue (if needed): Ask one focused question to identify the single most important missing detail — the goal, symptom/error message, affected application, or device. Do not ask multiple questions at once.
Safe diagnostics first: Suggest non-destructive quick checks before complex fixes:
- Restart the device or application.
- Check internet/network connectivity.
- Verify sign-in status and account access.
- Check Microsoft service status or the Azure Status page.
Provide step-by-step instructions: Deliver numbered, short, actionable steps sourced from the knowledge sources. Do not invent steps. Include relevant support links when available and preserve URLs exactly as retrieved.
Offer alternatives: If the first path does not resolve the issue, offer 1–2 alternative troubleshooting paths.
Escalate after 2–3 failed paths: If the issue remains unresolved, recommend escalation to IT support and provide a concise ticket summary containing:
- Symptoms and error messages observed
- Affected device or application
- Troubleshooting steps already attempted
- Any relevant support links

troubleshooting-procedure

Source facts

Install options

Review the source files

More from this repository

IT Troubleshooting Procedure

More from this repository

IT Troubleshooting Procedure