CtrlK
BlogDocsLog inGet started
Tessl Logo

ff-oce-kusto

Use this skill for any Kusto query or telemetry investigation specifically related to Fluid Framework or its partners. Triggers include: writing or running a Kusto query against the Office Fluid database, investigating Fluid Framework telemetry or error rates, querying Office_Fluid_FluidRuntime_* tables, looking up a Fluid session by Session_Id or docId, investigating a Fluid-related error in Loop or Whiteboard telemetry, monitoring an FF bump or partner ring deployment, checking Fluid render reliability or Scriptor errors, or when the user mentions Fluid-specific tables (Office_Fluid_FluidRuntime_*, OwhLoads, HostTracker, Scriptor) or Fluid-specific error types (dataCorruptionError, dataProcessingError, DeltaConnectionFailureToConnect, ICE, ACE). Do NOT trigger for general Kusto questions that are not related to Fluid Framework.

72

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

A well-structured overview that puts exactly the right orientation material (access, tables, key fields, critical reminders) in SKILL.md and pushes ~1500 lines of detail into a single well-signaled, verified reference file. The main weaknesses are minor redundancy (VPN stated twice, intro echoing the description) and the absence of one inline example query to make the quick-start fully copy-paste ready.

Suggestions

Remove the duplicate VPN statement — fold the bullet 'VPN: Required (Microsoft internal network)' into the callout (or vice versa) and trim the opening paragraph, which restates the frontmatter description.

Add one short inline starter query (e.g., a basic Office_Fluid_FluidRuntime_Error lookup by Session_Id) so the most common action is executable without opening the reference file.

Make the investigation sequence more explicit by adding a brief numbered 'first stop' workflow (verify access → read reference → Error table → correlate via Session_Id/docId) with the VPN-failure checkpoint as an explicit early validation step.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious facts (cluster URL, database IDs, table names, correlation-ID hierarchy, exact filter strings) and defers bulk material to the reference file. However, the VPN requirement is stated twice (the callout and the 'VPN: Required' bullet) and the opening paragraph largely restates the frontmatter description, matching 'Efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

Concrete, directly usable details are given — exact database ID with usage instruction ('use this, not the pretty name, as the `database` parameter'), specific table names, the exact filters 'Data_stack !has ".goskope.com"' and 'Data_channelFactoryType !has ".myshn.net"', and the concrete 'hll() / dcount_hll(hll_merge(...))' pattern. It falls short of fully copy-paste-ready guidance only because no complete example query is inlined (all queries live one file away), matching 'Mostly executable guidance; concrete code or commands with minor gaps'.

4 / 5

Workflow Clarity

There is a clear sequence: check VPN/access, read the reference file before writing any non-trivial query, start at Office_Fluid_FluidRuntime_Error ('all errors (first stop)'), and the VPN note provides an explicit recovery checkpoint if a query fails to connect. Minor gaps remain — there is no explicit initial sanity-check step (e.g., run a trivial query to verify access), matching 'Clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

SKILL.md is a lean overview that signals exactly one one-level-deep reference ('Before writing any non-trivial Kusto query, read the full reference file: references/kusto-query-reference.md') and summarizes its four parts; the reference file exists and its actual structure (Parts 1–4, cookbook sections 2.1–2.20, playbook patterns, FF bump/render/Scriptor/video/stress-test sections) matches the summary. This matches 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'.

5 / 5

Total

17

/

20

Passed

Description

100%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.

An exemplary description: it states concrete capabilities, enumerates natural trigger phrases with domain-specific synonyms and exact table/error names, answers both what and when explicitly, and includes a negative trigger that sharply reduces conflict risk with general Kusto skills. Its length is dense with distinct triggers rather than padded.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'writing or running a Kusto query against the Office Fluid database', 'investigating Fluid Framework telemetry or error rates', 'looking up a Fluid session by Session_Id or docId', 'monitoring an FF bump or partner ring deployment', 'checking Fluid render reliability or Scriptor errors' — with comprehensive coverage of the skill's investigation scope. It matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; nothing is vague or padded.

5 / 5

Completeness

It explicitly answers both 'what' ('Kusto query or telemetry investigation specifically related to Fluid Framework or its partners') and 'when' ('Triggers include: ... or when the user mentions ...') with concrete trigger phrases, and even adds an explicit anti-trigger ('Do NOT trigger for general Kusto questions'). This is a direct match to the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'.

5 / 5

Trigger Term Quality

Trigger terms cover the natural vocabulary users would say in this domain: 'Kusto query', 'telemetry', 'error rates', 'Session_Id', 'docId', 'FF bump', 'render reliability', 'Scriptor errors', plus synonyms and concrete identifiers (Loop, Whiteboard, Office_Fluid_FluidRuntime_*, OwhLoads, HostTracker, dataCorruptionError, ICE, ACE). This matches the comprehensive-coverage anchor including synonyms and exact table/error-type names.

5 / 5

Distinctiveness Conflict Risk

The niche is highly specific (Fluid Framework telemetry on the Office Fluid cluster) and the explicit 'Do NOT trigger for general Kusto questions' boundary actively prevents overlap with generic Kusto skills. Clear niche with distinct triggers and minimal conflict risk, matching the top anchor.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
microsoft/FluidFramework
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.