Catalog
MicrosoftDocs/azure-boards

MicrosoftDocs

azure-boards

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).

globalRequires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
generated_at:2026-06-21
generator:docs2skills/1.0.0
New~2.2k
v1.0Saved 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.

Troubleshooting

Topic URL
Troubleshoot Azure DevOps Office integration issues https://learn.microsoft.com/en-us/azure/devops/boards/backlogs/office/tfs-office-integration-issues?view=azure-devops
Troubleshoot Azure DevOps Office integration issues https://learn.microsoft.com/en-us/azure/devops/boards/backlogs/office/tfs-office-integration-issues?view=azure-devops
Troubleshoot Azure DevOps Office integration issues https://learn.microsoft.com/en-us/azure/devops/boards/backlogs/office/tfs-office-integration-issues?view=azure-devops
Troubleshoot Azure Boards backlog nesting and reordering https://learn.microsoft.com/en-us/azure/devops/boards/backlogs/resolve-backlog-reorder-issues?view=azure-devops
Resolve common Azure Boards query issues https://learn.microsoft.com/en-us/azure/devops/boards/queries/query-faqs?view=azure-devops

Best Practices

Topic URL
Apply Azure Boards Agile product management practices https://learn.microsoft.com/en-us/azure/devops/boards/best-practices-agile-project-management?view=azure-devops
Apply scalable Agile practices in Azure Boards https://learn.microsoft.com/en-us/azure/devops/boards/plans/practices-that-scale?view=azure-devops
Apply Azure Boards sprint and Scrum best practices https://learn.microsoft.com/en-us/azure/devops/boards/sprints/best-practices-scrum?view=azure-devops

Decision Making

Topic URL
Select migration and integration options for Azure Boards https://learn.microsoft.com/en-us/azure/devops/boards/extensions/migrate-integrate?view=azure-devops
Choose Azure Boards tools for cross-team visibility https://learn.microsoft.com/en-us/azure/devops/boards/plans/visibility-across-teams?view=azure-devops
Choose the right Azure Boards process template https://learn.microsoft.com/en-us/azure/devops/boards/work-items/guidance/choose-process?view=azure-devops

Limits & Quotas

Topic URL
Manage and restore deleted Azure Boards test artifacts https://learn.microsoft.com/en-us/azure/devops/boards/backlogs/delete-test-artifacts?view=azure-devops
Manage Azure Boards work item attachments and limits https://learn.microsoft.com/en-us/azure/devops/boards/work-items/manage-attachments?view=azure-devops

Security

Topic URL
Understand default permissions and access in Azure Boards https://learn.microsoft.com/en-us/azure/devops/boards/get-started/permissions-access-boards?view=azure-devops
Configure query and folder permissions in Azure Boards https://learn.microsoft.com/en-us/azure/devops/boards/queries/set-query-permissions?view=azure-devops
Secure Azure Boards with access controls and policies https://learn.microsoft.com/en-us/azure/devops/boards/secure-your-azure-boards?view=azure-devops

Configuration

Topic URL
Configure and customize Azure Boards processes and boards https://learn.microsoft.com/en-us/azure/devops/boards/configure-customize?view=azure-devops
Configure on-premises Azure DevOps with GitHub Enterprise https://learn.microsoft.com/en-us/azure/devops/boards/github/connect-on-premises-to-github?view=azure-devops-server
Configure Azure Boards GitHub app connections https://learn.microsoft.com/en-us/azure/devops/boards/github/install-github-app?view=azure-devops
Configure Azure Boards query charts for dashboards https://learn.microsoft.com/en-us/azure/devops/boards/queries/example-query-charts?view=azure-devops
Use Azure Boards query fields, operators, and macros https://learn.microsoft.com/en-us/azure/devops/boards/queries/query-operators-variables?view=azure-devops
Track bugs, issues, and risks fields in CMMI process https://learn.microsoft.com/en-us/azure/devops/boards/work-items/guidance/cmmi/guidance-bugs-issues-risks-field-reference-cmmi?view=azure-devops
Use code review and feedback fields in Azure Boards https://learn.microsoft.com/en-us/azure/devops/boards/work-items/guidance/guidance-code-review-feedback-field-reference?view=azure-devops
Reference Agile and Scrum work item fields in Azure Boards https://learn.microsoft.com/en-us/azure/devops/boards/work-items/guidance/work-item-field?view=azure-devops
Configure and manage Azure Boards work item fields https://learn.microsoft.com/en-us/azure/devops/boards/work-items/work-item-fields?view=azure-devops

Integrations & Coding Patterns

Topic URL
Add Azure Boards status badges to GitHub repos https://learn.microsoft.com/en-us/azure/devops/boards/github/configure-status-badges?view=azure-devops
Integrate Azure Boards projects with GitHub repositories https://learn.microsoft.com/en-us/azure/devops/boards/github/connect-to-github?view=azure-devops
Integrate Azure Boards work items with GitHub artifacts https://learn.microsoft.com/en-us/azure/devops/boards/github/link-to-from-github?view=azure-devops
Integrate GitHub Copilot with Azure Boards work items https://learn.microsoft.com/en-us/azure/devops/boards/github/work-item-integration-github-copilot?view=azure-devops
Integrate Azure Boards with Slack channels https://learn.microsoft.com/en-us/azure/devops/boards/integrations/boards-slack?view=azure-devops
Use Azure Boards with Microsoft Teams channels https://learn.microsoft.com/en-us/azure/devops/boards/integrations/boards-teams?view=azure-devops
Use WIQL syntax for Azure Boards queries https://learn.microsoft.com/en-us/azure/devops/boards/queries/wiql-syntax?view=azure-devops
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

72/100

Grade

B

Good

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.

Detected Capabilities

documentation fetching (remote)web content retrievalknowledge indexingURL reference navigationconditional tool selection (mcp_microsoftdocs or fetch_webpage)

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

azure boards troubleshootingconfigure azure boardsazure boards github integrationwiql query helpazure boards process templateazure boards permissionsscrum sprint planning

Risk Signals

INFO

Network-dependent documentation retrieval via mcp_microsoftdocs or fetch_webpage

Skill frontmatter and 'How to Use This Skill' section
INFO

External URL references to learn.microsoft.com (26 URLs across all categories)

Troubleshooting, Best Practices, Decision Making, Limits & Quotas, Security, Configuration, and Integrations & Coding Patterns sections
INFO

Conditional dependency check: alerts user if mcp_microsoftdocs not available

'How to Use This Skill' section
INFO

Metadata staleness check: suggests updating if generated_at > 3 months old

'How to Use This Skill' section

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Troubleshoot Azure Boards Office integration issues
  • Resolve backlog nesting and reordering problems
  • Select appropriate Azure Boards process templates
  • Configure GitHub integrations with Azure Boards
  • Manage work item security and permissions
  • Query work items using WIQL syntax
  • Integrate Azure Boards with Teams or Slack
  • Design Scrum or Agile process boards
  • Link GitHub artifacts to Azure Boards work items
  • Manage work item attachments and limits

Quality Notes

  • Strength: Clear Category Index with line ranges and descriptions enabling precise navigation. Agents can locate content efficiently.
  • Strength: Dual-tool fallback strategy (mcp_microsoftdocs preferred, fetch_webpage fallback) reduces failure risk if primary tool unavailable.
  • Strength: Scope is well-defined — covers Azure Boards only, explicitly excludes Azure DevOps, Test Plans, Pipelines, and Repos.
  • Strength: Metadata staleness check guides users toward keeping documentation current.
  • 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.

Add MicrosoftDocs/azure-boards to your library

Command Palette

Search for a command to run...