| name | azure-sdk-python-sample-review |
| description | Reviews Azure SDK Python code samples for best practices, credential handling, async patterns, error handling, and documentation compliance. Trigger: "review Python Azure SDK sample", "check Python sample", "Azure SDK Python review". |
| status | active |
| tags | ["review","python","azure","sdk","sample","check","best","practices","code","reviewing"] |
| category | review |
USE FOR
- "review Python Azure SDK sample"
- "check Python sample for best practices"
- "Azure SDK Python code review"
- Reviewing credential handling in Azure SDK Python samples
- Error pattern and async pattern analysis for Python Azure SDK samples
- Documentation compliance check for Python Azure SDK samples
DO NOT USE FOR
- General Python code review unrelated to Azure SDK samples
- Production application code review
- Azure service configuration
Context
Base template: Inherits from azure-sdk-sample-review for shared review patterns (credentials, error handling, documentation, infrastructure). This skill adds Python-specific rules below.
Reviews Python code samples for Azure SDKsintended for publication as Microsoft Azure samples. Focuses on Track 2 azure-* packages, DefaultAzureCredential, service-specific patterns (Cosmos DB, SQL, Storage, Service Bus, Key Vault, AI), sample hygiene, documentation accuracy, IaC (Bicep/Terraform), azd integration, and async patterns.
Total rules: 75 (11 CRITICAL, 23 HIGH, 32 MEDIUM, 9 LOW)
Severity Legend
- CRITICAL = security/won't run
- HIGH = confuses users
- MEDIUM = best practice
- LOW = polish
Quick Pre-Review Checklist (5-Minute Scan)
Blocker Issues (Auto-Reject)
- Hardcoded secrets in code
- Missing authentication or insecure auth methods
- No error handling / bare
except: blocks
- Broken imports / missing dependencies
- Critical/high CVEs in
pip-audit
- Missing LICENSE at any repo hierarchy level. âš ï¸ Check repo root first.
- .env committed to git. âš ï¸ Verify with
git ls-files .env.
- Track 1 packages (legacy pre-Track-2 APIs)
Detailed Rules
Language-Specific References (Python code examples)
Companion Skills
- azure-sdk-typescript-sample-review — TypeScript equivalent (shared IaC/azd patterns)
- azure-sdk-dotnet-sample-review — .NET 9/10 + Aspire
- azure-sdk-java-sample-review — Java 17/21 + Spring Boot
- azure-sdk-go-sample-review — Go 1.21+
- acrolinx-score-improvement — Article quality and style
Summary
75 rules covering Azure SDK Python sample quality: authentication, client patterns, service-specific best practices (AI, Data, Messaging, Key Vault, Vector Search), infrastructure-as-code, async patterns, documentation, and CI/CD. Apply to ensure samples are secure, accurate, and publication-ready.
References
References location: All reference files for this skill live inside the skill directory at .github/skills/data-plus-ai-sdk-python-sample-review/. Paths like references/file.md resolve to .github/skills/data-plus-ai-sdk-python-sample-review/references/file.md. Paths are relative to the skill folder, not the repo root.