CtrlK
BlogDocsLog inGet started
Tessl Logo

agui-dotnet-agents-sync

Keep the AG-UI .NET SDK docs (sdks/dotnet/AGENTS.md and docs/architecture.md) in sync with the real code tree after structural changes. USE FOR: "update AGENTS.md / docs/architecture.md", "check the dotnet docs are current", verifying docs after a .NET SDK refactor (package rename, added/removed project, changed endpoint pattern, new/renamed test project, sample step added, new convention). DO NOT USE FOR: writing product code or tests (follow AGENTS.md itself), Python/TypeScript SDK docs, or generic markdown editing unrelated to the dotnet SDK structure.

72

Quality

88%

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

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

The body is an exemplary command-driven reconciliation workflow: concrete PowerShell ground-truth derivation, a claim-to-command drift checklist, an explicit verify step, and strong anti-drift guardrails. The only weaknesses are mild repetition of the 'derive from the tree' principle across sections and no offloading of detail into reference files.

DimensionReasoningScore

Conciseness

The body is dominated by concrete commands and a table rather than explanations of concepts Claude already knows, matching 'efficient; minor instances of over-explanation that could be trimmed'. It is not 5 because the core principle ("derive the truth from the tree first" / "never edit from memory") is restated across four sections (intro quote, process step 1, 'Deriving ground truth', anti-patterns 1), which could be consolidated. It is not 3 because none of the content is padding or generic explanation — every section carries real information.

4 / 5

Actionability

Fully executable, copy-paste-ready PowerShell commands with exact paths and patterns ("Select-String -Path AGUI.slnx -Pattern '<Project Path'", "Get-ChildItem samples/GettingStarted -Directory -Filter Step*", "grep Microsoft.AspNetCore src\*\*.csproj (must be empty)"), plus a concrete drift checklist mapping each claim to the command that verifies it. This matches anchor 5 (copy-paste ready commands covering the common cases); the commands are complete and specific, not pseudocode or high-level hints.

5 / 5

Workflow Clarity

A clear four-step sequence (establish ground truth → drift scan → fix surgically → verify) with an explicit validation step ("Re-grep every symbol/name you wrote to confirm it exists in the tree. Optionally dotnet build") and a feedback loop, plus a dedicated drift checklist for the fragile claims. This matches anchor 5 (explicit validation steps, feedback, checklist); the batch-edit workflow's verification is not merely implied as at anchor 4.

5 / 5

Progressive Disclosure

Well-organized single-file skill with clear sections and a 'Files to mine' navigation pointer; content is appropriately placed for a single-purpose skill. It matches anchor 4 ('good structure; most content is appropriately placed; minor organization gaps') rather than 5 because at ~85 lines, beyond the simple-skill exception, all content lives in SKILL.md with no one-level-deep reference files for the checklist/durable-facts detail, and there are no well-signaled references as the anchor-5 example requires. No bundle files exist to verify against.

4 / 5

Total

18

/

20

Passed

Description

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

The description is precise, scoped, and trigger-rich: it names the exact target files, gives explicit USE FOR trigger phrases, and fences the boundary with a DO NOT USE FOR clause. Minor room remains in broadening trigger-term synonyms and enumerating the concrete actions more fully.

DimensionReasoningScore

Specificity

Names the domain and concrete actions with exact file paths ("sdks/dotnet/AGENTS.md and docs/architecture.md") and enumerates specific change types ("package rename, added/removed project, changed endpoint pattern, new/renamed test project, sample step added"), but the action set is essentially one task (sync/verify) rather than a list of several distinct operations, so it falls between the 'several specific actions' (4) and 'comprehensive multiple actions' (5) anchors — closer to 4.

4 / 5

Completeness

Explicitly answers both: what ("Keep the AG-UI .NET SDK docs ... in sync with the real code tree after structural changes") and when ("USE FOR: ... verifying docs after a .NET SDK refactor"), plus negative scope ("DO NOT USE FOR: writing product code or tests..."). This clearly matches the anchor 5 example structure of concrete 'what' plus explicit trigger phrases, and nothing is missing for a higher level.

5 / 5

Trigger Term Quality

Includes natural quoted phrases users would actually say ("update AGENTS.md / docs/architecture.md", "check the dotnet docs are current") plus concrete refactor vocabulary, matching 'good keyword coverage; a few natural terms missing'. Not 5 because it lacks synonym/extension variations (e.g., 'AGENTS doc', 'architecture overview') that would give comprehensive coverage; not 3 because the trigger phrasing is explicit and natural rather than merely 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

A clear niche (AG-UI .NET SDK docs sync) with distinct triggers and an explicit exclusion list that fences off adjacent skills ("Python/TypeScript SDK docs, or generic markdown editing"), so conflict risk is minimal. It matches anchor 5 ('clear niche with distinct triggers'); it is not 4 because the DO NOT USE clause removes even the minor overlap with adjacent documentation skills.

5 / 5

Total

18

/

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.

Validation — 16 / 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.