Menú
Azure Boards work item tools for querying, viewing, creating, and updating work items
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Safe wrappers for common Unix utilities
Safe wrappers for common Unix utilities
Allow nerf tools without prompting (supports glob patterns like nerf-git-*)
Allow/deny nerf tools by threat profile (read/write ceiling)
Deny nerf tools entirely (supports glob patterns like nerf-git-*)
List nerf tool permissions across all scopes
| name | nerf-az-boards |
| description | Azure Boards work item tools for querying, viewing, creating, and updating work items |
| targets | ["*"] |
These tools are available as scripts within this skill. Call them using the paths shown in each usage line.
These tools interact with Azure Boards work items. The organization and project are auto-detected from the git remote in the current directory. Pass --project to target a different project, or -C to resolve the project from the git remote of a sub-directory (useful when multiple repos live under one workspace root and you don't want to cd around). The az-boards-wi-* tools operate on any work item. The az-boards-mywi-* tools are scoped to work items assigned to you. az-boards-area-list lists area paths in a project, useful for setting --area on create/update.
Query work items using WIQL (Work Item Query Language). Returns matching work items as JSON. The organization and project are auto-detected from the git remote; pass --project to override.
Usage: scripts/nerf-az-boards-wi-list [--project|-p <project>] [-C <directory>] <wiql>
Maps to: az boards query --wiql <wiql> <project> --output json
Options:
--project|-p (optional): Azure DevOps project name or ID (auto-detected from the git remote if omitted)-C (optional): Resolve the Azure DevOps project from the git remote of this directory instead of cwd (must be under cwd)Arguments:
<wiql> (required): WIQL query string (e.g. "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.AssignedTo] = @Me AND [System.State] <> 'Closed' ORDER BY [System.ChangedDate] DESC")Show details and comments for any work item.
Usage: scripts/nerf-az-boards-wi-show [--project|-p <project>] [-C <directory>] <wi_id>
Maps to: az boards work-item show --id <wi_id> <project> --output json
Options:
--project|-p (optional): Azure DevOps project name or ID (auto-detected from the git remote if omitted)-C (optional): Resolve the Azure DevOps project from the git remote of this directory instead of cwd (must be under cwd)Arguments:
<wi_id> (required): Work item ID (numeric). must match ^[0-9]+$Add a comment to any work item.
Usage: scripts/nerf-az-boards-wi-comment [--project|-p <project>] [-C <directory>] <wi_id> <comment>
Maps to: az boards work-item update --id <wi_id> --discussion <comment> <project> --output none
Options:
--project|-p (optional): Azure DevOps project name or ID (auto-detected from the git remote if omitted)-C (optional): Resolve the Azure DevOps project from the git remote of this directory instead of cwd (must be under cwd)Arguments:
<wi_id> (required): Work item ID (numeric). must match ^[0-9]+$<comment> (required): Comment text. Stored as HTML on the work item, so HTML markup renders (e.g. "See this
"). Plain text is stored verbatim and renders as-is.Update fields on a work item. Supports state, title, assigned-to, area, iteration, and adding a discussion comment. Returns the updated work item as JSON.
Usage: scripts/nerf-az-boards-wi-update [--state <state>] [--title <title>] [--assigned-to <assigned_to>] [--area <area>] [--iteration <iteration>] [--discussion <discussion>] [--fields|-f <fields>] [--project|-p <project>] [-C <directory>] <wi_id>
Maps to: az boards work-item update --id <wi_id> <state> <title> <assigned_to> <area> <iteration> <discussion> <fields> <project> --output json
Options:
--state (optional): New state (e.g. Active, Resolved, Closed)--title (optional): New title--assigned-to (optional): Person to assign to (e.g. user@example.com)--area (optional): Area path (e.g. MyProject\MyArea)--iteration (optional): Iteration path (e.g. MyProject\Sprint 1)--discussion (optional): Comment to add to the work item discussion. Stored as HTML, so HTML markup renders; plain text renders as-is.--fields|-f (optional): Custom field assignment (e.g. "System.Tags=Rock")--project|-p (optional): Azure DevOps project name or ID (auto-detected from the git remote if omitted)-C (optional): Resolve the Azure DevOps project from the git remote of this directory instead of cwd (must be under cwd)Arguments:
<wi_id> (required): Work item ID (numeric). must match ^[0-9]+$Create a new work item. Requires a type and title. Optionally set assigned-to, area, iteration, description, and a discussion comment. Returns the created work item as JSON.
Usage: scripts/nerf-az-boards-wi-create [--assigned-to <assigned_to>] [--area <area>] [--iteration <iteration>] [--description|-d <description>] [--discussion <discussion>] [--fields|-f <fields>] [--project|-p <project>] [-C <directory>] <type> <title>
Maps to: az boards work-item create --type <type> --title <title> <assigned_to> <area> <iteration> <description> <discussion> <fields> <project> --output json
Options:
--assigned-to (optional): Person to assign to (e.g. user@example.com)--area (optional): Area path (e.g. MyProject\MyArea)--iteration (optional): Iteration path (e.g. MyProject\Sprint 1)--description|-d (optional): Description of the work item. Stored as HTML, so HTML markup renders (e.g. "Steps:
--discussion (optional): Comment to add to the work item discussion. Stored as HTML, so HTML markup renders; plain text renders as-is.--fields|-f (optional): Custom field assignment (e.g. "System.Tags=Rock")--project|-p (optional): Azure DevOps project name or ID (auto-detected from the git remote if omitted)-C (optional): Resolve the Azure DevOps project from the git remote of this directory instead of cwd (must be under cwd)Arguments:
<type> (required): Work item type (e.g. Bug, Task, User Story, Feature)<title> (required): Title of the work itemSet the parent of a work item. Takes the child ID and parent ID as positional arguments. Idempotent if the link already exists.
Usage: scripts/nerf-az-boards-wi-add-parent [--project|-p <project>] [-C <directory>] <child_id> <parent_id>
Maps to: az boards work-item relation add --id <child_id> --relation-type parent --target-id <parent_id> <project> --output json
Options:
--project|-p (optional): Azure DevOps project name or ID (auto-detected from the git remote if omitted)-C (optional): Resolve the Azure DevOps project from the git remote of this directory instead of cwd (must be under cwd)Arguments:
<child_id> (required): Work item ID of the child (numeric). must match ^[0-9]+$<parent_id> (required): Work item ID of the parent (numeric). must match ^[0-9]+$List work items assigned to you that are not Closed or Removed, ordered by most recently changed. Returns matching work items as JSON.
Usage: scripts/nerf-az-boards-mywi-list [--project|-p <project>] [-C <directory>]
Options:
--project|-p (optional): Azure DevOps project name or ID (auto-detected from the git remote if omitted)-C (optional): Resolve the Azure DevOps project from the git remote of this directory instead of cwd (must be under cwd)Show details and comments for a work item assigned to you. Verifies that System.AssignedTo matches the current user; refuses items assigned to anyone else (use az-boards-wi-show for those).
Usage: scripts/nerf-az-boards-mywi-show [--project|-p <project>] [-C <directory>] <wi_id>
Options:
--project|-p (optional): Azure DevOps project name or ID (auto-detected from the git remote if omitted)-C (optional): Resolve the Azure DevOps project from the git remote of this directory instead of cwd (must be under cwd)Arguments:
<wi_id> (required): Work item ID (numeric, must be assigned to you). must match ^[0-9]+$Add a comment to a work item assigned to you. Verifies that System.AssignedTo matches the current user; refuses items assigned to anyone else (use az-boards-wi-comment for those).
Usage: scripts/nerf-az-boards-mywi-comment [--project|-p <project>] [-C <directory>] <wi_id> <comment>
Options:
--project|-p (optional): Azure DevOps project name or ID (auto-detected from the git remote if omitted)-C (optional): Resolve the Azure DevOps project from the git remote of this directory instead of cwd (must be under cwd)Arguments:
<wi_id> (required): Work item ID (numeric, must be assigned to you). must match ^[0-9]+$<comment> (required): Comment text. Stored as HTML on the work item, so HTML markup renders (e.g. "See this
"). Plain text is stored verbatim and renders as-is.Update state or title on a work item assigned to you. Verifies that System.AssignedTo matches the current user; refuses items assigned to anyone else (use az-boards-wi-update for those). To reassign, use az-boards-wi-update.
Usage: scripts/nerf-az-boards-mywi-update [--state <state>] [--title <title>] [--project|-p <project>] [-C <directory>] <wi_id>
Options:
--state (optional): New work item state (e.g. Active, Resolved, Closed)--title (optional): New work item title--project|-p (optional): Azure DevOps project name or ID (auto-detected from the git remote if omitted)-C (optional): Resolve the Azure DevOps project from the git remote of this directory instead of cwd (must be under cwd)Arguments:
<wi_id> (required): Work item ID (numeric, must be assigned to you). must match ^[0-9]+$List area paths configured in a project. Returns the hierarchical area tree as JSON. Useful for setting --area on az-boards-wi-create or az-boards-wi-update.
Usage: scripts/nerf-az-boards-area-list [--project|-p <project>] [-C <directory>]
Maps to: az boards area project list <project> --output json
Options:
--project|-p (optional): Azure DevOps project name or ID (auto-detected from the git remote if omitted)-C (optional): Resolve the Azure DevOps project from the git remote of this directory instead of cwd (must be under cwd)Hit a bug, complaint, bypass-worthy guardrail, or want a feature? Use the nerf-report skill.