CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-ai-document-intelligence-dotnet

Azure AI Document Intelligence SDK for .NET. Extract text, tables, and structured data from documents using prebuilt and custom models.

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/azure-ai-document-intelligence-dotnet/SKILL.md

The canonical home for this skill is azure-ai-document-intelligence-dotnet in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

57%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, highly actionable API reference with copy-paste-ready code for all major workflows. Its weaknesses are the absence of any progressive disclosure (everything inlined in one 330-line file), a destructive DeleteModel call with no validation, and scattered padding (redundant tables, a filler 'When to Use' section, a version stamp, and repeated analysis snippets).

Suggestions

Add a warning or verification step (e.g. list and confirm the model ID before deletion) around the destructive `DeleteModelAsync` call in workflow 7.

Move the Key Types Reference, Build Modes, and model/classifier administration detail into a references/ file, keeping SKILL.md as a lean overview with clearly signaled one-level-deep links.

Delete the redundant "Related SDKs" single-row table and the filler "When to Use" sentence, and relocate or remove the time-sensitive "Current Version: v1.0.0" stamp; tighten the near-duplicate invoice/receipt extraction snippets.

Define the variables used in snippets (receiptUri, documentUri, endpoint/apiKey in the admin example) so every code block is fully self-contained.

DimensionReasoningScore

Conciseness

The body is mostly efficient tables and code, but there is unnecessary content that could be tightened: a "Related SDKs" table with a single row restating this same SDK, a filler "When to Use" sentence ("This skill is applicable to execute the workflow or actions described in the overview."), a time-sensitive "Current Version: v1.0.0 (GA)" stamp not placed in a deprecated/old-patterns section, and three near-duplicate analysis code blocks (invoice/receipt patterns). This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trims-only level 4.

3 / 5

Actionability

Nearly all guidance is concrete, executable C# with real model IDs ("prebuilt-invoice", "prebuilt-layout"), install commands, env vars, and error handling — mostly copy-paste ready. Minor gaps keep it below 5: workflow 3 uses an undefined `receiptUri`, the error-handling snippet uses an undefined `documentUri`, and the admin-client example references undefined `endpoint`/`apiKey` locals.

4 / 5

Workflow Clarity

The seven workflows are clearly labeled and each shows a complete call-and-process-result flow, and a try/catch error-handling section exists. However, workflow 7 includes a destructive operation — `adminClient.DeleteModelAsync("my-model-id")` — with no warning, confirmation, or validation step, and long-running builds have no post-build verification, triggering the destructive-operation cap of 3. It is above level 2 because sequences and code are well defined, not poorly sketched.

3 / 5

Progressive Disclosure

The skill has good internal structure (clear section headers, tables) but no bundle files exist (no references/, scripts/, or assets/), and ~330 lines of content that could live in separate files are all inlined — e.g. the "Key Types Reference" and "Build Modes" tables and detailed model-administration workflows. This matches 'some structure but... content that should be separate is inline' rather than level 4, since there are no well-signaled one-level-deep references at all, only external web links.

3 / 5

Total

13

/

20

Passed

Description

66%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 solid, third-person description with concrete actions and a clearly named niche, but it omits any 'Use when...' trigger guidance, which caps completeness and weakens trigger-term coverage. Adding a when-to-use clause with natural synonyms (OCR, Form Recognizer, invoices, PDFs) would raise it substantially.

Suggestions

Append a 'Use when...' clause, e.g. "Use when working with Azure AI Document Intelligence / Form Recognizer in .NET, extracting text or tables from PDFs, invoices, receipts, or building custom document models in C#".

Include natural synonyms users actually say — "OCR", "Form Recognizer" (the service's former name), "invoices", "receipts", "PDF" — to improve trigger-term coverage.

Mention classification and model building/training capabilities so the 'what' covers more of the skill's actual scope.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Extract text, tables, and structured data from documents" — and distinguishes "prebuilt and custom models", which goes beyond naming the domain. It stops short of a 5 because higher-level capabilities (classification, building/training models, invoices/receipts/ID documents) are absent, leaving minor coverage gaps.

4 / 5

Completeness

The 'what' is clearly stated ("Extract text, tables, and structured data from documents using prebuilt and custom models") but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description, capping completeness at 3 per the judging guidelines. It is not a 4 because 'when' is entirely absent rather than merely under-specified.

3 / 5

Trigger Term Quality

Natural terms a user would say are present: "Azure AI Document Intelligence SDK", ".NET", "extract text", "tables", "documents", "prebuilt and custom models". A few natural terms are missing — users commonly say "OCR", "Form Recognizer" (the service's former name), "PDF", "invoices", or "forms" — which keeps it at the 'good coverage, a few natural terms missing' anchor rather than 5.

4 / 5

Distinctiveness Conflict Risk

Naming the specific product and stack ("Azure AI Document Intelligence SDK for .NET") creates a clear niche with distinct triggers, scoring mostly distinct with minimal conflict risk. It is not a 5 because the generic trailing phrase "documents... extract text, tables" could overlap with generic PDF/document-extraction skills in a crowded library.

4 / 5

Total

15

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/azure-ai-document-intelligence-dotnet/SKILL.md

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.