Expert knowledge for Azure Boards development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing work items, queries/charts, GitHub links, Scrum boards/sprints, or WIQL-based integrations, and other Azure Boards related development tasks. Not for Azure DevOps (use azure-devops), Azure Test Plans (use azure-test-plans), Azure Pipelines (use azure-pipelines), Azure Repos (use azure-repos).
v1.0LATEST
NewUpdated Jun 26, 2026
Azure Boards Skill
This skill provides expert guidance for Azure Boards. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.
How to Use This Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file
IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
Category
Lines
Description
Troubleshooting
L35-L43
Diagnosing and fixing Azure Boards issues with Office integration, backlog nesting/reordering, and common query problems (filters, clauses, results).
Best Practices
L44-L50
Guidance on using Azure Boards for Agile product management, scaling Agile across teams, and applying Scrum/sprint planning, tracking, and execution best practices.
Decision Making
L51-L57
Guidance on selecting Azure Boards process templates, migration/integration approaches, and tools for cross-team visibility and reporting across projects.
Limits & Quotas
L58-L63
Managing Azure Boards limits for test artifacts and work item attachments, including size/quantity constraints and how to restore deleted test-related items.
Security
L64-L70
Managing Azure Boards security: default permissions, configuring query/folder access, and setting access controls and policies for teams and users.
Configuration
L71-L83
Configuring Azure Boards processes, fields, and boards; linking with GitHub; and defining queries, charts, and work item field usage for Agile, Scrum, CMMI, bugs, and code reviews.
Integrations & Coding Patterns
L84-L93
Connecting Azure Boards to GitHub, Copilot, Slack, and Teams, adding status badges, linking work items to code/artifacts, and querying work items with WIQL syntax.
Grades are signals, not a certification. Always review a skill yourself before use.
Safety
85
Quality
68
Clarity
78
Completeness
62
Summary
This skill provides curated reference knowledge for Azure Boards troubleshooting, best practices, configuration, and integrations. It acts as a documentation navigator and decision-making guide for Azure Boards users, directing agents to remote Microsoft Learn documentation via structured category indices and URL references. The skill does not execute commands or write files — it is purely advisory and read-only.
Weakness: Content sections (L35–L93) are referenced but not included in the skill file itself — agents must read lines from the primary SKILL.md or call external tools. Line ranges in the index are descriptive but the actual content is missing.
Weakness: No error handling guidance if documentation fetch fails or returns partial content. No fallback strategies documented for network failures.
Weakness: URL list contains a duplicate entry (Troubleshoot Office integration appears 3x in Troubleshooting section, lines 36–38).
Weakness: No guidance on interpreting or applying retrieved documentation — skill focuses on navigation rather than synthesis or decision-making patterns.
Weakness: No examples of WIQL queries, process template comparisons, or security configuration workflows to ground the guidance.
Weakness: Compatibility note mentions 'Requires network access' but does not specify minimum connectivity requirements or timeouts.
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026
Reviews
Add this skill to your library to leave a review.
No reviews yet
Be the first to share your experience.
Use MicrosoftDocs/azure-boards in your dev environment — a Developer account adds skills to your library and syncs them via the SkillRepo CLI.