CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

57

Quality

66%

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 ./skills/azure-ai-document-intelligence-dotnet/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

64%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a solid SDK reference skill with excellent actionability — all code examples are complete, executable, and cover the key use cases well. However, it suffers from being monolithic (no progressive disclosure via bundle files) and lacks validation checkpoints in multi-step workflows like custom model building. Some content like boilerplate sections and type reference tables add bulk without proportional value.

Suggestions

Split detailed code examples (custom model building, classifier workflows) and reference tables (prebuilt models, key types) into separate bundle files, keeping SKILL.md as a concise overview with quick-start examples

Add validation checkpoints to the custom model building workflow — e.g., verify training data structure before building, check model accuracy after build, include retry guidance for failed operations

Remove the boilerplate 'When to Use' and 'Limitations' sections which add no SDK-specific value

Integrate error handling into the workflow examples rather than as a separate section, showing where failures commonly occur and how to recover

DimensionReasoningScore

Conciseness

The skill is fairly comprehensive but includes some unnecessary content like the 'When to Use' and 'Limitations' boilerplate sections, the 'Related SDKs' table, and explanatory notes Claude would already know (e.g., 'clients are thread-safe'). The prebuilt models table and key types reference table add bulk that could be in a separate reference file. However, the code examples themselves are lean and well-structured.

2 / 3

Actionability

All code examples are fully executable C# with proper using statements, concrete API calls, and realistic field extraction patterns. The examples cover the full range of operations (analyze, build, classify, manage) with copy-paste ready code including proper null/type checking patterns.

3 / 3

Workflow Clarity

The workflows are presented as isolated examples rather than sequenced multi-step processes. For the custom model building workflow (which involves training data preparation, building, and validation), there are no validation checkpoints or feedback loops — e.g., no guidance on verifying model accuracy, handling build failures, or validating training data before building. The error handling section is separate rather than integrated into workflows.

2 / 3

Progressive Disclosure

The content is a monolithic ~300-line file with no bundle files to offload detailed reference content. The prebuilt models table, key types reference, and detailed code examples for 7 different workflows could be split into separate reference files. The reference links section at the end provides external navigation but the internal content organization is flat.

2 / 3

Total

9

/

12

Passed

Description

67%Scale 1-3

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 technically specific and clearly identifies the technology stack and concrete capabilities, making it distinctive. However, it lacks an explicit 'Use when...' clause, which limits its completeness for skill selection. Adding natural trigger terms like 'OCR', 'Form Recognizer', 'C#', and common file types would improve discoverability.

Suggestions

Add a 'Use when...' clause such as 'Use when the user needs to analyze documents with Azure AI Document Intelligence, Form Recognizer, or OCR in a .NET/C# project.'

Include common user-facing trigger terms and synonyms like 'OCR', 'Form Recognizer' (the former product name), 'C#', 'document analysis', and file extensions like '.pdf', '.tiff', '.jpeg'.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Extract text, tables, and structured data from documents' and specifies the technology stack ('Azure AI Document Intelligence SDK for .NET') along with model types ('prebuilt and custom models').

3 / 3

Completeness

Clearly answers 'what does this do' (extract text, tables, structured data using Azure AI Document Intelligence SDK for .NET), but lacks an explicit 'Use when...' clause or equivalent trigger guidance, capping this at 2 per the rubric.

2 / 3

Trigger Term Quality

Includes relevant keywords like 'Azure AI Document Intelligence', 'SDK', '.NET', 'extract text', 'tables', 'structured data', and 'documents', but misses common user variations like 'OCR', 'form recognizer', 'C#', 'document analysis', or file type extensions like '.pdf', '.docx'.

2 / 3

Distinctiveness Conflict Risk

The combination of 'Azure AI Document Intelligence SDK' and '.NET' creates a very specific niche that is unlikely to conflict with generic document processing skills or other cloud provider SDKs.

3 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation — 10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
popey/claude-code-skills
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.