CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-ai-document-intelligence-ts

Extract text, tables, and structured data from documents using prebuilt and custom models.

Quality

74%

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-claude/skills/azure-ai-document-intelligence-ts/SKILL.md

The canonical home for this skill is azure-ai-document-intelligence-ts in sickn33/agentic-awesome-skills

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.

The body is a strong, code-first reference: complete and executable examples cover authentication, analysis, extraction, and custom model/classifier workflows with a clearly numbered polling pattern. Weaknesses are the absence of any progressive disclosure (all API reference material inlined in one file), a redundant repeated polling section, a filler closing line, and no error-recovery guidance after a failed poll or low-confidence field.

Suggestions

Split per-model extraction examples, the prebuilt-model table, and the Key Types listing into a references/ file (e.g. MODELS.md), keeping SKILL.md as a concise overview with clearly signaled one-level-deep links.

Remove the duplicated "Polling Pattern" section (or the inline repetitions in each example) and delete the filler "When to Use" sentence, replacing it with genuine trigger guidance.

Add error-recovery guidance: what to do when polling fails or stalls, and how to apply the confidence-score threshold mentioned in Best Practices.

DimensionReasoningScore

Conciseness

The body is dominated by lean, copy-ready code with almost no concept explanations Claude already knows — it assumes competence. It is not a 5 because the "Polling Pattern" section largely repeats the isUnexpected/poller/pollUntilDone sequence already shown in three earlier examples, and the closing line "This skill is applicable to execute the workflow or actions described in the overview" is pure filler.

4 / 5

Actionability

Every section is complete, executable TypeScript: both auth flows, URL and base64-local-file analysis, field extraction for invoices/receipts, model listing with paginate, custom model and classifier builds, and classification. Install commands and env vars make it copy-paste ready, matching the anchor for fully executable code covering the common cases.

5 / 5

Workflow Clarity

The numbered "Polling Pattern" section gives a clear sequence with an explicit error checkpoint (isUnexpected) and optional progress monitoring, and analysis flows are non-destructive so the destructive/batch cap does not apply. It falls short of 5 because there are no feedback loops for error recovery (what to do when polling fails or a field's confidence is low) and no verification step on results; it is above 3 because checkpoints are present, not merely implied.

4 / 5

Progressive Disclosure

The skill is a single ~320-line file with no bundle files, and substantial reference material is inlined — the prebuilt-model table, per-model field-extraction examples (invoice, receipt), and the "Key Types" import listing would fit better in a separate references file, mirroring the level-3 anchor of API-reference content that should be separate living inline. It is not a 2 because section headers keep the file navigable and nothing is buried, and not a 4 because no progressive disclosure exists at all beyond one flat file.

3 / 5

Total

16

/

20

Passed

Description

58%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 gives a concrete, third-person 'what' with a distinguishing prebuilt/custom-model qualifier, but omits any 'when to use' trigger guidance and lacks the natural synonyms (PDF, OCR, invoice, receipt) users would most likely say. Adding an explicit 'Use when...' clause with those trigger terms would raise completeness and trigger-term quality substantially.

Suggestions

Append an explicit trigger clause, e.g. "Use when extracting text, tables, or fields from PDFs, images, invoices, receipts, or other documents, or when the user mentions Azure Document Intelligence or OCR."

Include natural synonyms and concrete document types (PDF, invoice, receipt, ID document, OCR) so common user phrasings match.

Mention the additional capabilities already covered in the body (classify documents, build/train custom models) to make the 'what' comprehensive.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Extract text, tables, and structured data" — qualified by "using prebuilt and custom models", matching the anchor for several specific actions with minor gaps. It is not a 5 because capabilities demonstrated in the body (classifying documents, building/training custom models, listing models) are absent, and not a 3 since more than 1-2 concrete actions are named.

4 / 5

Completeness

The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3. It is not a 2 because the 'what' is specific rather than vague, and not a 4 because the 'when' is entirely missing rather than merely weak.

3 / 5

Trigger Term Quality

Keywords present ("documents", "text", "tables", "structured data", "prebuilt and custom models") are relevant but miss the natural variations users actually say: "PDF", "OCR", "invoice", "receipt", or file extensions. This fits the anchor for some relevant keywords missing common variations/synonyms rather than the level-4 'good coverage with a few missing', since the most common user phrasings for this domain are absent.

3 / 5

Distinctiveness Conflict Risk

The phrase "using prebuilt and custom models" carves out a fairly distinct niche (model-based document analysis) with only minor overlap risk against generic PDF/document-library skills. It is not a 5 because the service name (Azure Document Intelligence), TypeScript, and domain terms (OCR, invoice, receipt) that would fully disambiguate it are missing, leaving some overlap with general document-extraction skills.

4 / 5

Total

14

/

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-claude/skills/azure-ai-document-intelligence-ts/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.