Skill Files: Teaching Your Agent

Write it once in markdown. Agent reads it every time.

📄 AGENTS.md

# How to query Kusto

## Clusters we use
- Production: shellprod.kusto.windows.net
- Dev: shelldev.kusto.windows.net

## Common queries
Crash rate:
CrashEvents | where bin == "explorer.exe"
| summarize count() by bin(timestamp, 1h)

📄 skills/investigate-bug/SKILL.md

# How to investigate a bug

## Steps
1. Read the bug in ADO
2. Check crash telemetry in Kusto
3. Find the code owner via git blame
4. Check recent PRs to that file
5. Look for related ICM incidents

## Tips
Always check the deployment ring first.

Key insight: Skill files replace "stumbling on the right incantations."
You teach the agent once. It remembers forever.