devskill 2.0.7 → 2.0.8

package/skills/azure-devops-cli/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/azure-devops-cli/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: azure-devops-cli
+description: Manage Azure DevOps resources via CLI including projects, repos, pipelines, builds, pull requests, work items, artifacts, and service endpoints. Use when working with Azure DevOps, az commands, devops automation, CI/CD, or when user mentions Azure DevOps CLI.
+---
+
+# Azure DevOps CLI
+
+Manage Azure DevOps resources using the Azure CLI with the Azure DevOps extension.
+
+**CLI Version:** 2.81.0 (current as of 2025)
+
+## Prerequisites
+
+```bash
+# Install Azure CLI
+brew install azure-cli  # macOS
+curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash  # Linux
+
+# Install Azure DevOps extension
+az extension add --name azure-devops
+```
+
+## Authentication
+
+```bash
+# Login with PAT token
+az devops login --organization https://dev.azure.com/{org} --token YOUR_PAT_TOKEN
+
+# Set default organization and project (avoids repeating --org/--project)
+# Note: Legacy URL https://{org}.visualstudio.com should be replaced with https://dev.azure.com/{org}
+az devops configure --defaults organization=https://dev.azure.com/{org} project={project}
+
+# List current configuration
+az devops configure --list
+```
+
+## CLI Structure
+
+```
+az devops          # Main DevOps commands
+├── admin          # Administration (banner)
+├── extension      # Extension management
+├── project        # Team projects
+├── security       # Security operations
+│   ├── group      # Security groups
+│   └── permission # Security permissions
+├── service-endpoint # Service connections
+├── team           # Teams
+├── user           # Users
+├── wiki           # Wikis
+├── configure      # Set defaults
+├── invoke         # Invoke REST API
+├── login          # Authenticate
+└── logout         # Clear credentials
+
+az pipelines       # Azure Pipelines
+├── agent          # Agents
+├── build          # Builds
+├── folder         # Pipeline folders
+├── pool           # Agent pools
+├── queue          # Agent queues
+├── release        # Releases
+├── runs           # Pipeline runs
+├── variable       # Pipeline variables
+└── variable-group # Variable groups
+
+az boards          # Azure Boards
+├── area           # Area paths
+├── iteration      # Iterations
+└── work-item      # Work items
+
+az repos           # Azure Repos
+├── import         # Git imports
+├── policy         # Branch policies
+├── pr             # Pull requests
+└── ref            # Git references
+
+az artifacts       # Azure Artifacts
+└── universal      # Universal Packages
+```
+
+## Reference Files
+
+Read the relevant reference file based on the user's task. Each file contains complete command syntax and examples for its domain.
+
+| File | When to read | Covers |
+|---|---|---|
+| `references/repos-and-prs.md` | Repos, branches, pull requests, branch policies | Repositories, Import, PRs (create/list/vote/reviewers/policies), Git refs, Branch policies |
+| `references/pipelines-and-builds.md` | Pipelines, builds, releases, artifacts | Pipelines CRUD, runs, builds, releases, artifacts download/upload |
+| `references/boards-and-iterations.md` | Work items, sprints, area paths | Work items (WIQL/create/update/relations), Area paths, Iterations, Team iterations |
+| `references/variables-and-agents.md` | Pipeline variables, agent pools | Pipeline variables, Variable groups, Pipeline folders, Agent pools/queues |
+| `references/org-and-security.md` | Projects, teams, users, permissions, wikis | Projects, Extensions, Teams, Users, Security groups/permissions, Service endpoints, Wikis, Admin |
+| `references/advanced-usage.md` | Output formatting, JMESPath queries | Output formats, JMESPath queries (basic + advanced), Global args, Common params, Git aliases |
+| `references/workflows-and-patterns.md` | Automation scripts, best practices, error handling | Common workflows, Best practices, Error handling, Scripting patterns, Real-world examples |

package/skills/azure-devops-cli/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/azure-devops-cli`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/azure-devops-cli/references/advanced-usage.md

@@ -0,0 +1,197 @@
+# Advanced Usage: Output, Queries & Parameters
+
+## Table of Contents
+- [Output Formats](#output-formats)
+- [JMESPath Queries](#jmespath-queries)
+- [Advanced JMESPath Queries](#advanced-jmespath-queries)
+- [Global Arguments](#global-arguments)
+- [Common Parameters](#common-parameters)
+- [Git Aliases](#git-aliases)
+- [Getting Help](#getting-help)
+
+---
+
+## Output Formats
+
+All commands support multiple output formats:
+
+```bash
+# Table format (human-readable)
+az pipelines list --output table
+
+# JSON format (default, machine-readable)
+az pipelines list --output json
+
+# JSONC (colored JSON)
+az pipelines list --output jsonc
+
+# YAML format
+az pipelines list --output yaml
+
+# YAMLC (colored YAML)
+az pipelines list --output yamlc
+
+# TSV format (tab-separated values)
+az pipelines list --output tsv
+
+# None (no output)
+az pipelines list --output none
+```
+
+## JMESPath Queries
+
+Filter and transform output:
+
+```bash
+# Filter by name
+az pipelines list --query "[?name=='myPipeline']"
+
+# Get specific fields
+az pipelines list --query "[].{Name:name, ID:id}"
+
+# Chain queries
+az pipelines list --query "[?name.contains('CI')].{Name:name, ID:id}" --output table
+
+# Get first result
+az pipelines list --query "[0]"
+
+# Get top N
+az pipelines list --query "[0:5]"
+```
+
+## Advanced JMESPath Queries
+
+### Filtering and Sorting
+
+```bash
+# Filter by multiple conditions
+az pipelines list --query "[?name.contains('CI') && enabled==true]"
+
+# Filter by status and result
+az pipelines runs list --query "[?status=='completed' && result=='succeeded']"
+
+# Sort by date (descending)
+az pipelines runs list --query "sort_by([?status=='completed'], &finishTime | reverse(@))"
+
+# Get top N items after filtering
+az pipelines runs list --query "[?result=='succeeded'] | [0:5]"
+```
+
+### Nested Queries
+
+```bash
+# Extract nested properties
+az pipelines show --id $PIPELINE_ID --query "{Name:name, Repo:repository.{Name:name, Type:type}, Folder:folder}"
+
+# Query build details
+az pipelines build show --id $BUILD_ID --query "{ID:id, Number:buildNumber, Status:status, Result:result, Requested:requestedFor.displayName}"
+```
+
+### Complex Filtering
+
+```bash
+# Find pipelines with specific YAML path
+az pipelines list --query "[?process.type.name=='yaml' && process.yamlFilename=='azure-pipelines.yml']"
+
+# Find PRs from specific reviewer
+az repos pr list --query "[?contains(reviewers[?displayName=='John Doe'].displayName, 'John Doe')]"
+
+# Find work items with specific iteration and state
+az boards work-item show --id $WI_ID --query "{Title:fields['System.Title'], State:fields['System.State'], Iteration:fields['System.IterationPath']}"
+```
+
+### Aggregation
+
+```bash
+# Count items by status
+az pipelines runs list --query "groupBy([?status=='completed'], &[result]) | {Succeeded: [?key=='succeeded'][0].count, Failed: [?key=='failed'][0].count}"
+
+# Get unique reviewers
+az repos pr list --query "unique_by(reviewers[], &displayName)"
+
+# Sum values
+az pipelines runs list --query "[?result=='succeeded'] | [].{Duration:duration} | [0].Duration"
+```
+
+### Conditional Transformation
+
+```bash
+# Format dates
+az pipelines runs list --query "[].{ID:id, Date:createdDate, Formatted:createdDate | format_datetime(@, 'yyyy-MM-dd HH:mm')}"
+
+# Conditional output
+az pipelines list --query "[].{Name:name, Status:(enabled ? 'Enabled' : 'Disabled')}"
+
+# Extract with defaults
+az pipelines show --id $PIPELINE_ID --query "{Name:name, Folder:folder || 'Root', Description:description || 'No description'}"
+```
+
+### Complex Workflows
+
+```bash
+# Find longest running builds
+az pipelines build list --query "sort_by([?result=='succeeded'], &queueTime) | reverse(@) | [0:3].{ID:id, Number:buildNumber, Duration:duration}"
+
+# Get PR statistics per reviewer
+az repos pr list --query "groupBy([], &reviewers[].displayName) | [].{Reviewer:@.key, Count:length(@)}"
+
+# Find work items with multiple child items
+az boards work-item relation list --id $PARENT_ID --query "[?rel=='System.LinkTypes.Hierarchy-Forward'] | [].{ChildID:url | split('/', @) | [-1]}"
+```
+
+## Global Arguments
+
+Available on all commands:
+
+| Parameter | Description |
+|---|---|
+| `--help` / `-h` | Show command help |
+| `--output` / `-o` | Output format (json, jsonc, none, table, tsv, yaml, yamlc) |
+| `--query` | JMESPath query string for filtering output |
+| `--verbose` | Increase logging verbosity |
+| `--debug` | Show all debug logs |
+| `--only-show-errors` | Only show errors, suppress warnings |
+| `--subscription` | Name or ID of subscription |
+| `--yes` / `-y` | Skip confirmation prompts |
+
+## Common Parameters
+
+| Parameter | Description |
+|---|---|
+| `--org` / `--organization` | Azure DevOps organization URL (e.g., `https://dev.azure.com/{org}`) |
+| `--project` / `-p` | Project name or ID |
+| `--detect` | Auto-detect organization from git config |
+| `--yes` / `-y` | Skip confirmation prompts |
+| `--open` | Open resource in web browser |
+| `--subscription` | Azure subscription (for Azure resources) |
+
+## Git Aliases
+
+After enabling git aliases:
+
+```bash
+# Enable Git aliases
+az devops configure --use-git-aliases true
+
+# Use Git commands for DevOps operations
+git pr create --target-branch main
+git pr list
+git pr checkout 123
+```
+
+## Getting Help
+
+```bash
+# General help
+az devops --help
+
+# Help for specific command group
+az pipelines --help
+az repos pr --help
+
+# Help for specific command
+az repos pr create --help
+
+# Search for examples
+az find "az repos pr create"
+```

package/skills/azure-devops-cli/references/boards-and-iterations.md

@@ -0,0 +1,258 @@
+# Work Items, Area Paths & Iterations
+
+## Table of Contents
+- [Work Items (Boards)](#work-items-boards)
+- [Area Paths](#area-paths)
+- [Iterations](#iterations)
+
+---
+
+## Work Items (Boards)
+
+### Query Work Items
+
+```bash
+# WIQL query
+az boards query \
+  --wiql "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.AssignedTo] = @Me AND [System.State] = 'Active'"
+
+# Query with output format
+az boards query --wiql "SELECT * FROM WorkItems" --output table
+```
+
+### Show Work Item
+
+```bash
+az boards work-item show --id {work-item-id}
+az boards work-item show --id {work-item-id} --open
+```
+
+### Create Work Item
+
+```bash
+# Basic work item
+az boards work-item create \
+  --title "Fix login bug" \
+  --type Bug \
+  --assigned-to user@example.com \
+  --description "Users cannot login with SSO"
+
+# With area and iteration
+az boards work-item create \
+  --title "New feature" \
+  --type "User Story" \
+  --area "Project\\Area1" \
+  --iteration "Project\\Sprint 1"
+
+# With custom fields
+az boards work-item create \
+  --title "Task" \
+  --type Task \
+  --fields "Priority=1" "Severity=2"
+
+# With discussion comment
+az boards work-item create \
+  --title "Issue" \
+  --type Bug \
+  --discussion "Initial investigation completed"
+
+# Open in browser after creation
+az boards work-item create --title "Bug" --type Bug --open
+```
+
+### Update Work Item
+
+```bash
+# Update state, title, and assignee
+az boards work-item update \
+  --id {work-item-id} \
+  --state "Active" \
+  --title "Updated title" \
+  --assigned-to user@example.com
+
+# Move to different area
+az boards work-item update \
+  --id {work-item-id} \
+  --area "{ProjectName}\\{Team}\\{Area}"
+
+# Change iteration
+az boards work-item update \
+  --id {work-item-id} \
+  --iteration "{ProjectName}\\Sprint 5"
+
+# Add comment/discussion
+az boards work-item update \
+  --id {work-item-id} \
+  --discussion "Work in progress"
+
+# Update with custom fields
+az boards work-item update \
+  --id {work-item-id} \
+  --fields "Priority=1" "StoryPoints=5"
+```
+
+### Delete Work Item
+
+```bash
+# Soft delete (can be restored)
+az boards work-item delete --id {work-item-id} --yes
+
+# Permanent delete
+az boards work-item delete --id {work-item-id} --destroy --yes
+```
+
+### Work Item Relations
+
+```bash
+# List relations
+az boards work-item relation list --id {work-item-id}
+
+# List supported relation types
+az boards work-item relation list-type
+
+# Add relation
+az boards work-item relation add --id {work-item-id} --relation-type parent --target-id {parent-id}
+
+# Remove relation
+az boards work-item relation remove --id {work-item-id} --relation-id {relation-id}
+```
+
+## Area Paths
+
+### List Areas for Project
+
+```bash
+az boards area project list --project {project}
+az boards area project show --path "Project\\Area1" --project {project}
+```
+
+### Create Area
+
+```bash
+az boards area project create --path "Project\\NewArea" --project {project}
+```
+
+### Update Area
+
+```bash
+az boards area project update \
+  --path "Project\\OldArea" \
+  --new-path "Project\\UpdatedArea" \
+  --project {project}
+```
+
+### Delete Area
+
+```bash
+az boards area project delete --path "Project\\AreaToDelete" --project {project} --yes
+```
+
+### Area Team Management
+
+```bash
+# List areas for team
+az boards area team list --team {team-name} --project {project}
+
+# Add area to team
+az boards area team add \
+  --team {team-name} \
+  --path "Project\\NewArea" \
+  --project {project}
+
+# Remove area from team
+az boards area team remove \
+  --team {team-name} \
+  --path "Project\\AreaToRemove" \
+  --project {project}
+
+# Update team area
+az boards area team update \
+  --team {team-name} \
+  --path "Project\\Area" \
+  --project {project} \
+  --include-sub-areas true
+```
+
+## Iterations
+
+### List Iterations for Project
+
+```bash
+az boards iteration project list --project {project}
+az boards iteration project show --path "Project\\Sprint 1" --project {project}
+```
+
+### Create Iteration
+
+```bash
+az boards iteration project create --path "Project\\Sprint 1" --project {project}
+```
+
+### Update Iteration
+
+```bash
+az boards iteration project update \
+  --path "Project\\OldSprint" \
+  --new-path "Project\\NewSprint" \
+  --project {project}
+```
+
+### Delete Iteration
+
+```bash
+az boards iteration project delete --path "Project\\OldSprint" --project {project} --yes
+```
+
+### Team Iterations
+
+```bash
+# List iterations for team
+az boards iteration team list --team {team-name} --project {project}
+
+# Add iteration to team
+az boards iteration team add \
+  --team {team-name} \
+  --path "Project\\Sprint 1" \
+  --project {project}
+
+# Remove iteration from team
+az boards iteration team remove \
+  --team {team-name} \
+  --path "Project\\Sprint 1" \
+  --project {project}
+
+# List work items in iteration
+az boards iteration team list-work-items \
+  --team {team-name} \
+  --path "Project\\Sprint 1" \
+  --project {project}
+```
+
+### Default & Backlog Iterations
+
+```bash
+# Set default iteration for team
+az boards iteration team set-default-iteration \
+  --team {team-name} \
+  --path "Project\\Sprint 1" \
+  --project {project}
+
+# Show default iteration
+az boards iteration team show-default-iteration \
+  --team {team-name} \
+  --project {project}
+
+# Set backlog iteration for team
+az boards iteration team set-backlog-iteration \
+  --team {team-name} \
+  --path "Project\\Sprint 1" \
+  --project {project}
+
+# Show backlog iteration
+az boards iteration team show-backlog-iteration \
+  --team {team-name} \
+  --project {project}
+
+# Show current iteration
+az boards iteration team show --team {team-name} --project {project} --timeframe current
+```