KUSTO GRAPH QUERIES / Microsoft
Kusto Graph Semantics
Pins Microsoft's Kusto graph skill, which requires the exact command and an explicit confirmation before a graph model or snapshot is created, altered, or dropped.
“Build and query Kusto graphs from natural language. Covers transient graphs (make-graph), persistent graph models/snapshots, pattern matching (graph-match), shortest paths, connected components, and graph-to-table export. Generates the edges-first thinking: define edges, define node lookups, union, make-graph. WHEN: make-graph, graph-match, graph-shortest-paths, graph-to-table, graph-mark-components, persistent graph, graph model, graph snapshot, build a graph from data, find paths between nodes, pattern matching in graph, connected components, transient graph, Kusto graph, KQL graph.”
01 / THE REASONING
Why this made the selection.
- Control commands that create, alter, or drop graph models and snapshots must be shown with cluster, database, and object, then explicitly confirmed.
- Writing a file or launching an executable waits for ask_user, and the file forbids shell interpolation and putting a query in a browser URL.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- .github/plugins/azure-kusto-graph-skills/skills/azure-kusto-graph/SKILL.md
- README.md
- .github/plugins/azure-kusto-graph-skills/README.md
- LICENSE
- .github/plugins/azure-kusto-graph-skills/LICENSE
Our findings
- Creating or altering a graph model or snapshot is called a database modification that must be shown and confirmed before it runs.
- Drop, create-or-alter graph_model, and make graph_snapshot are not executed automatically. The file requires the command, cluster, database, object, and an explicit confirmation.
- A file write or an executable launch waits for ask_user, and the file contents are shown in chat first.
- Shell interpolation, here-strings, and encoding a query into a browser URL are refused.
- Kusto Explorer auto-launch is opt-in. The default is to print the KQL in chat, plus a tabular variant for ADX Web Explorer.
Not established by this review
- The resource was not executed.
- No graph model, snapshot, or drop command was sent, and no file was written.
- The referenced examples, scenarios, and launch procedure were not opened.
- The plugin was not installed.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- The azure-kusto-graph-skills README names the skill and does not print an install command.
- The repository README shows `npx skills add microsoft/skills`, a wizard for the whole repository, and `/plugin install azure@skills`, which is a different plugin.
- Do not treat either repository line as an install of this file.
Before you start
- A Kusto cluster and database the operator chooses if a query is run; this review did not connect
- Copilot CLI is the plugin host named in the repository README. This plugin README does not name a host
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- azure-kusto-graph SKILL.md ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-kusto-graph-skills/skills/azure-kusto-graph/SKILL.md
Supports: confirm-before-control-command, ask_user before file writes, and no browser-URL encoding
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-kusto-graph-skills/README.md
Supports: npx warning and telemetry opt-out; no install command
- Repository README ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md
Supports: whole-repository wizard, a different plugin install line, and the MIT statement
- Repository LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE
Supports: MIT License
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-kusto-graph-skills/LICENSE
Supports: MIT License, same terms as the repository LICENSE
https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-kusto-graph-skills/skills/azure-kusto-graph/SKILL.md
Supports: upstreamDescription, bestFor, review.reviewedAt, review.notTested