Name: azure-search-documents-py
Rating: 58.4 (1 reviews)
Author: administrakt0r

Blog Docs Log in Get started

azure-search-documents-py

Azure AI Search SDK for Python. Use for vector search, hybrid search, semantic ranking, indexing, and skillsets.

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/azure-search-documents-py/SKILL.md

The canonical home for this skill is azure-search-documents-py in administrakt0r/AI-Agents-Safe-Coding-Skills

Quality

Content

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

Highly actionable code examples undermined by severe redundancy — the skill is effectively written twice — and broken references to bundle files that do not exist. Removing the duplicate half and creating the referenced files would dramatically improve quality.

Suggestions

Delete the duplicated 'Additional Azure AI Search Patterns' section (lines ~319-532); it repeats installation, auth, client selection, search patterns, and best practices already covered above.

Create the referenced bundle files (references/vector-search.md, references/semantic-ranking.md, scripts/setup_vector_index.py) or remove the Reference Files table — the listed paths do not exist.

Add an ordered end-to-end workflow with a validation checkpoint for batch/destructive operations (e.g. create index -> upload documents -> verify document count -> run query).

Dimension	Reasoning	Score
Conciseness	The body duplicates nearly the entire skill: installation, authentication, client selection, index creation, search patterns, and best practices all appear twice (once before and once after the 'Additional Azure AI Search Patterns' divider), severely padding the token budget.	1 / 5
Actionability	Provides fully executable, copy-paste-ready code for auth, index creation, vector/hybrid/semantic search, filters, facets, autocomplete, indexers with skillsets, buffered upload, async, and error handling.	5 / 5
Workflow Clarity	Sections are organized by capability but there is no sequenced end-to-end workflow with validation checkpoints, and batch/destructive operations (upload, delete, indexer runs) include no verify-before-proceeding feedback loop, capping this at 3.	3 / 5
Progressive Disclosure	The Reference Files table points to references/vector-search.md, references/semantic-ranking.md, and scripts/setup_vector_index.py, but none of these bundle files exist; meanwhile large API-reference material and the entire duplicated second document are inlined rather than split out.	2 / 5
	Total	11 / 20 Passed

Description

92%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 concise, well-targeted description that clearly states both the domain and concrete trigger use cases. Minor improvement possible by adding natural synonyms users might actually say.

Dimension	Reasoning	Score
Specificity	Names the SDK and lists multiple concrete capabilities — 'vector search, hybrid search, semantic ranking, indexing, and skillsets' — giving comprehensive coverage of distinct actions.	5 / 5
Completeness	Explicitly answers what ('Azure AI Search SDK for Python') and when ('Use for vector search, hybrid search, semantic ranking, indexing, and skillsets') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Strong natural keywords like 'vector search', 'hybrid search', and 'semantic ranking' but missing common synonyms or variations a user might say (e.g. 'RAG', 'embeddings', 'Azure Search').	4 / 5
Distinctiveness Conflict Risk	Clear niche — the Azure AI Search Python SDK — with specific triggers unlikely to conflict with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

81%

Warnings & errors only

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

Validation — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (532 lines); consider splitting into references/ and linking	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
referenced_paths_exist	Referenced path issues: 4 missing	Warning

	Total	13 / 16 Passed

Repository: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: plugins/AI-Agents-Safe-Coding-Skills-claude/skills/azure-search-documents-py/SKILL.md
Commit: 57c135b

Reviewed: 20 hours ago

Table of Contents

Discovery Implementation Validation

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.