CtrlK
BlogDocsLog inGet started
Tessl Logo

agui-dotnet-troubleshoot

Diagnose and fix problems in an AG-UI .NET app built on the AG-UI SDK — when streaming chat, tools, state, interrupts, or the transport misbehave. USE FOR: the agent forgetting earlier turns / history truncated; update.ConversationId always null; state or lifecycle updates that never arrive; a tool throwing at runtime or producing AOT/trim warnings; an unknown-tool error mid-run; 406 Not Acceptable from the endpoint; an interrupt or approval that won't resume; and inspecting the raw AG-UI event stream (curl SSE frames, RawEvent on ChatResponseUpdate.RawRepresentation) to see what's actually on the wire. DO NOT USE FOR: first-time setup or the happy path (use agui-dotnet-streaming-chat); implementing a specific feature cleanly (use the matching agui-dotnet-* skill).

80

Quality

100%

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

100%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 tight, high-signal troubleshooting skill: symptom-driven sections each yield an executable fix, code is copy-paste ready, and a verify-the-fix section closes the loop. No fluff and no prerequisite knowledge re-explained.

DimensionReasoningScore

Conciseness

The body is lean: each section is a tight symptom→cause→Fix triplet with no padding or explanation of concepts Claude already knows, and the curl/C# snippets earn their tokens.

5 / 5

Actionability

Every fix gives copy-paste-ready, executable guidance — e.g. the curl SSE command, `UseFunctionInvocation(fic => fic.TerminateOnUnknownCalls = true)`, and the `RawEvent` pattern-match snippet — covering the common cases concretely.

5 / 5

Workflow Clarity

Symptoms are mapped to causes and fixes in a clear sequence, and the final 'Verify the fix' section provides an explicit validation checkpoint with a feedback loop (reproduce the original prompt, confirm the symptom is gone).

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so for this well-organized single-purpose troubleshooting skill the sectioned structure (symptom headers + a verify section) is clear and self-contained, satisfying the simple-skill exception.

5 / 5

Total

20

/

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.

A strong, specific troubleshooting description that pairs concrete symptom phrases with explicit use/avoid boundaries and names sibling skills for disambiguation. It avoids fluff and reads the way a user would describe their problem.

DimensionReasoningScore

Specificity

The description enumerates concrete actions such as 'Diagnose and fix problems', 'inspecting the raw AG-UI event stream (curl SSE frames, RawEvent on ChatResponseUpdate.RawRepresentation)', and 'mapping a symptom to its cause', giving comprehensive coverage of the skill's capabilities.

5 / 5

Completeness

It explicitly answers both 'what' (diagnose and fix AG-UI .NET streaming/transport/state problems) and 'when' via a concrete 'USE FOR' clause plus a 'DO NOT USE FOR' negative boundary, satisfying the top anchor.

5 / 5

Trigger Term Quality

It uses natural phrases users would actually say — 'the agent forgetting earlier turns / history truncated', 'update.ConversationId always null', '406 Not Acceptable', 'an interrupt or approval that won't resume' — covering symptom-level vocabulary comprehensively.

5 / 5

Distinctiveness Conflict Risk

A clear niche (AG-UI .NET troubleshooting) with distinct symptom triggers and explicit negative guidance naming sibling skills (agui-dotnet-streaming-chat, agui-dotnet-*) minimizes conflict risk.

5 / 5

Total

20

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
ag-ui-protocol/ag-ui
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.