Name: azure-search-documents-py
Rating: 59.2 (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

70%

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/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

65%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 highly actionable body with comprehensive executable examples, weakened by duplicated sections, missing validation checkpoints for batch/destructive operations, and references to bundle files that do not exist.

Suggestions

Remove the duplicated second half ('Additional Azure AI Search Patterns' / '# Azure AI Search Python SDK') and consolidate the overlapping Installation, Authentication, Client, and Best Practices sections.

Add explicit validation checkpoints for batch and destructive operations (e.g., verify upload results, check indexing status before query).

Create the referenced bundle files (references/vector-search.md, references/semantic-ranking.md, references/agentic-retrieval.md, scripts/setup_vector_index.py) or remove the broken references so navigation matches reality.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient executable code with little over-explanation, but it duplicates whole sections (Installation, Environment Variables, Authentication, Client Selection, Best Practices) under 'Additional Azure AI Search Patterns', which is unnecessary padding that could be tightened.	3 / 5
Actionability	It provides fully executable, copy-paste-ready code covering installation, auth, index creation, search, vector/hybrid/semantic search, filters, facets, autocomplete, and indexers across the common cases.	5 / 5
Workflow Clarity	The body lists sequential patterns for batch uploads and index management, but includes no explicit validation/verification checkpoints for batch or destructive operations (upload, merge, delete, create_or_update), which caps workflow clarity at 3 per the rubric.	3 / 5
Progressive Disclosure	Section structure exists and a Reference Files table signals one-level-deep pointers, but the referenced bundle files (references/vector-search.md, references/semantic-ranking.md, references/agentic-retrieval.md, scripts/setup_vector_index.py) do not exist in the bundle, and large amounts of reference-grade content are inlined.	3 / 5
	Total	14 / 20 Passed

Description

75%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 specific, distinct description that names concrete capabilities, but it lacks an explicit 'Use when...' trigger clause, which caps completeness and slightly weakens trigger-term quality.

Suggestions

Add an explicit 'Use when...' clause naming natural user phrases (e.g., 'Use when the user needs Azure AI Search, vector/hybrid search, or semantic ranking in Python').

Include synonyms or product aliases like 'Azure AI Search', 'Azure Cognitive Search' to broaden trigger coverage.

Dimension	Reasoning	Score
Specificity	The description lists five concrete capabilities — 'vector search, hybrid search, semantic ranking, indexing, and skillsets' — giving comprehensive coverage of the Azure AI Search domain.	5 / 5
Completeness	The 'what' is clear ('Azure AI Search SDK for Python' plus capabilities), but the 'when' is only weakly implied via 'Use for' with no explicit 'Use when the user mentions...' trigger clause, capping completeness at 3 per the rubric.	3 / 5
Trigger Term Quality	Natural technical terms like 'vector search', 'hybrid search', 'semantic ranking', and 'skillsets' are present, but synonyms and file/extension variations (e.g., 'Azure AI Search', 'cognitive search') are missing.	4 / 5
Distinctiveness Conflict Risk	'Azure AI Search SDK for Python' carves out a clear niche with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	17 / 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/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.