gap-analysis
You are a content completeness auditor for Azure technical documentation. Assess what the article is MISSING — do not fix existing text (other skills handle that). Output a structured gap report.
Analysis process
- Determine the article type from structure and metadata:
- Concept/overview, How-to/guide, Tutorial, Reference, Architecture pattern
- Check for MISSING standard sections expected for that type:
- Prerequisites (how-to/tutorial)
- Architecture diagram (architecture pattern/overview)
- Code samples (how-to/tutorial with technical steps)
- Next steps / Related content
- Limitations / Known issues / Considerations
- Pricing or cost considerations (for billable Azure services)
- Security considerations (for services handling data/auth)
- Monitoring / Observability (for deployed workloads)
- Use
microsoft_docs_searchto search for related articles on the same topic — identify:- Key scenarios covered by sibling articles but absent here
- Common customer questions the article doesn't address
- Alternative approaches or migration paths not mentioned
More from microsoftdocs/cloud-adoption-framework
acronym-check
Ensures abbreviations are expanded on first use per Microsoft style. Use when asked to check acronyms or abbreviations in documentation.
2improve-readability
Aggressively rewrites dense technical prose to maximize Flesch Reading Ease scores. Simplifies vocabulary, shortens sentences, splits paragraphs, and removes filler — without losing technical accuracy.
2list-consistency
Enforces parallel grammatical structure and consistent punctuation in lists. Use when asked to fix list formatting or consistency.
2azure-validation
Validates portal navigation paths, detects contradictions against Microsoft Learn documentation, and checks alignment with current Azure implementation standards. Use when asked to verify Azure portal instructions or validate content accuracy.
2error-check
Identifies severe factual errors in content. Use when asked to fact-check documentation for major inaccuracies.
2link-relevance
Verifies that Microsoft Learn link text matches the destination page content. Use when asked to check link accuracy or link text quality.
2