search-work-items

Search for Azure DevOps work items using text search and filters. IMPORTANT - Only use Bug or User Story types by default, exclude Enabler and other types.

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 7, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill provides a powerful interface to search and filter Azure DevOps work items, specifically optimized for retrieving Bugs and User Stories. It enhances project visibility by allowing users to query tickets using text search, assignment status, area paths, and custom tags, ensuring efficient tracking of development tasks and issues directly within the AI conversation.

Use Cases

  • Bug Tracking: Quickly locate active bugs related to specific features or keywords (e.g., 'authentication' or 'UI') to prioritize fixes.
  • Sprint Management: Filter and list User Stories assigned to specific team members to monitor workload and progress during stand-ups.
  • Project Auditing: Search for work items within specific area paths or iterations to generate status overviews for stakeholders.
  • Issue Discovery: Use tag-based filtering and state filters to find all resolved items related to specific release cycles or hotfixes.
namesearch-work-items
descriptionSearch for Azure DevOps work items using text search and filters. IMPORTANT - Only use Bug or User Story types by default, exclude Enabler and other types.

Search Azure DevOps Work Items

Search for Azure DevOps work items using text search and various filters. This skill helps find bugs and user stories across the project.

When to Use

  • User asks to find tickets, work items, or issues
  • Searching for items by keyword, feature name, or topic
  • Filtering by state, type, assignment, or tags
  • Finding all items in an area or iteration

Prerequisites

  • Azure DevOps must be initialized with Initialize-AzureDevOps
  • PAT token must be set (via parameter or AZURE_DEVOPS_PAT environment variable)

Examples

Search-WorkItems -SearchText "PDF export"

Search with filters

Search-WorkItems -SearchText "authentication" -WorkItemType "Bug" -State "Active"

Search by assignment

Search-WorkItems -AssignedTo "john.doe@company.com" -State "Active"

Search by area path

Search-WorkItems -AreaPath "MyProject\Backend" -WorkItemType "User Story"

Search by tags

Search-WorkItems -Tags "bug-fix" -State "Closed"

Parameters

  • SearchText: Text to search in title and description
  • WorkItemType: Bug, User Story, Task, Feature, etc. NOTE: Only use "Bug" or "User Story" - exclude Enabler and other types
  • State: New, Active, Resolved, Closed, etc.
  • AssignedTo: User email or display name
  • AreaPath: Area path to search under
  • IterationPath: Iteration path to search under
  • Tags: Tags to filter by
  • Top: Maximum results (default 200)

Output

Returns array of work item objects with:

  • Id, Type, Title, State
  • AssignedTo, CreatedBy, Created/Changed dates
  • Description, Acceptance Criteria
  • Priority, Effort, Tags
  • Area/Iteration paths
  • Web URL for viewing in Azure DevOps

Tips for Copilot

  • IMPORTANT: Default to Bug or User Story types only - do not include Enabler or other work item types unless explicitly requested
  • When user mentions a feature or component, search for it
  • Try multiple related search terms if first search yields no results
  • Combine filters to narrow down results
  • Use State filter to focus on active work vs. completed items
  • When filtering results, exclude Enabler type by default