Miferrac/azdoskills-refactor

docs/README.skills.md

@@ -25,7 +25,17 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
 | [agentic-eval](../skills/agentic-eval/SKILL.md) | Patterns and techniques for evaluating and improving AI agent outputs. Use this skill when:<br />- Implementing self-critique and reflection loops<br />- Building evaluator-optimizer pipelines for quality-critical generation<br />- Creating test-driven code refinement workflows<br />- Designing rubric-based or LLM-as-judge evaluation systems<br />- Adding iterative improvement to agent outputs (code, reports, analysis)<br />- Measuring and improving agent response quality | None |
 | [appinsights-instrumentation](../skills/appinsights-instrumentation/SKILL.md) | Instrument a webapp to send useful telemetry data to Azure App Insights | `LICENSE.txt`<br />`examples/appinsights.bicep`<br />`references/ASPNETCORE.md`<br />`references/AUTO.md`<br />`references/NODEJS.md`<br />`references/PYTHON.md`<br />`scripts/appinsights.ps1` |
 | [azure-deployment-preflight](../skills/azure-deployment-preflight/SKILL.md) | Performs comprehensive preflight validation of Bicep deployments to Azure, including template syntax validation, what-if analysis, and permission checks. Use this skill before any deployment to Azure to preview changes, identify potential issues, and ensure the deployment will succeed. Activate when users mention deploying to Azure, validating Bicep files, checking deployment permissions, previewing infrastructure changes, running what-if, or preparing for azd provision. | `references/ERROR-HANDLING.md`<br />`references/REPORT-TEMPLATE.md`<br />`references/VALIDATION-COMMANDS.md` |
-| [azure-devops-cli](../skills/azure-devops-cli/SKILL.md) | 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. | None |
+| [azure-devops-cli-admin](../skills/azure-devops-cli-admin/SKILL.md) | Azure DevOps administration via CLI for org banners and marketplace extensions, with quick workflows and reference commands. | `references/REFERENCE.md` |
+| [azure-devops-cli-artifacts](../skills/azure-devops-cli-artifacts/SKILL.md) | Manage Azure Artifacts universal packages with the CLI. | `references/REFERENCE.md` |
+| [azure-devops-cli-boards](../skills/azure-devops-cli-boards/SKILL.md) | Manage Azure Boards work items, queries, areas, and iterations with the CLI. | `references/REFERENCE.md`<br />`scripts/script.md` |
+| [azure-devops-cli-devops](../skills/azure-devops-cli-devops/SKILL.md) | Core Azure DevOps CLI setup, auth, configuration, projects, and global CLI usage patterns. | `references/REFERENCE.md` |
+| [azure-devops-cli-pipelines](../skills/azure-devops-cli-pipelines/SKILL.md) | Manage Azure Pipelines with the CLI, including runs, builds, releases, variables, and agents. | `references/REFERENCE.md` |
+| [azure-devops-cli-repos](../skills/azure-devops-cli-repos/SKILL.md) | Manage Azure Repos with the CLI, including repositories, pull requests, refs, and policies. | `references/REFERENCE.md` |
+| [azure-devops-cli-security](../skills/azure-devops-cli-security/SKILL.md) | Manage Azure DevOps security groups and permissions with the CLI. | `references/REFERENCE.md` |
+| [azure-devops-cli-service-endpoint](../skills/azure-devops-cli-service-endpoint/SKILL.md) | Manage Azure DevOps service endpoints and service connections with the CLI. | `references/REFERENCE.md` |
+| [azure-devops-cli-teams](../skills/azure-devops-cli-teams/SKILL.md) | Manage Azure DevOps teams with the CLI. | `references/REFERENCE.md` |
+| [azure-devops-cli-users](../skills/azure-devops-cli-users/SKILL.md) | Manage Azure DevOps users with the CLI. | `references/REFERENCE.md` |
+| [azure-devops-cli-wiki](../skills/azure-devops-cli-wiki/SKILL.md) | Manage Azure DevOps wikis and pages with the CLI. | `references/REFERENCE.md` |
 | [azure-resource-visualizer](../skills/azure-resource-visualizer/SKILL.md) | Analyze Azure resource groups and generate detailed Mermaid architecture diagrams showing the relationships between individual resources. Use this skill when the user asks for a diagram of their Azure resources or help in understanding how the resources relate to each other. | `LICENSE.txt`<br />`assets/template-architecture.md` |
 | [azure-role-selector](../skills/azure-role-selector/SKILL.md) | When user is asking for guidance for which role to assign to an identity given desired permissions, this agent helps them understand the role that will meet the requirements with least privilege access and how to apply that role. | `LICENSE.txt` |
 | [azure-static-web-apps](../skills/azure-static-web-apps/SKILL.md) | Helps create, configure, and deploy Azure Static Web Apps using the SWA CLI. Use when deploying static sites to Azure, setting up SWA local development, configuring staticwebapp.config.json, adding Azure Functions APIs to SWA, or setting up GitHub Actions CI/CD for Static Web Apps. | None |

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

@@ -0,0 +1,24 @@
+---
+name: azure-devops-cli-admin
+description: 'Azure DevOps administration via CLI for org banners and marketplace extensions, with quick workflows and reference commands.'
+---
+
+## When to Use This Skill
+
+- You want to configure the Azure DevOps CLI with defaults for easier command usage like project and organization.
+- You need to publish, update, or remove Azure DevOps org banners.
+- You need to search, install, enable, or remove Marketplace extensions in an org.
+- You want a quick CLI workflow for Azure DevOps admin tasks.
+
+## Prerequisites
+
+**CLI Version:** 2.81.0
+
+```bash
+# Install Azure DevOps extension
+az extension add --name azure-devops
+```
+
+## Guidelines
+
+Use the reference commands in [REFERENCE.md](references/REFERENCE.md) for specific admin tasks. Always confirm the organization URL and project context with the user before executing commands that modify settings or resources.

skills/azure-devops-cli-admin/references/REFERENCE.md

@@ -0,0 +1,59 @@
+# Azure DevOps CLI Admin
+
+Quick reference for common Azure DevOps admin CLI commands.
+
+- [Azure DevOps CLI Admin](#azure-devops-cli-admin)
+  - [Defaults](#defaults)
+  - [Banners](#banners)
+  - [Extensions](#extensions)
+
+## Defaults
+
+```bash
+# Set defaults for the organization (and optionally project)
+az devops configure --defaults organization=https://dev.azure.com/{org} project={project}
+```
+
+## Banners
+
+```bash
+# List banners
+az devops admin banner list
+
+# Add a banner
+az devops admin banner add \
+  --message "System maintenance scheduled" \
+  --level info
+
+# Update a banner
+az devops admin banner update \
+  --id {banner-id} \
+  --message "Updated message" \
+  --level warning
+
+# Remove a banner
+az devops admin banner remove --id {banner-id}
+```
+
+## Extensions
+
+```bash
+# List installed extensions
+az devops extension list --org https://dev.azure.com/{org}
+
+# Search Marketplace extensions
+az devops extension search --search-query "docker"
+
+# Install an extension
+az devops extension install \
+  --ext-id {extension-id} \
+  --org https://dev.azure.com/{org} \
+  --publisher {publisher-id}
+
+# Enable or disable an extension
+az devops extension enable --ext-id {extension-id} --org https://dev.azure.com/{org}
+az devops extension disable --ext-id {extension-id} --org https://dev.azure.com/{org}
+
+# Uninstall an extension
+az devops extension uninstall --ext-id {extension-id} --org https://dev.azure.com/{org} --yes
+```

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

@@ -0,0 +1,23 @@
+---
+name: azure-devops-cli-artifacts
+description: Manage Azure Artifacts universal packages with the CLI.
+---
+
+## When to Use This Skill
+
+- You want to publish or download Azure Artifacts universal packages using the CLI.
+- You need to manage package versions, views, or feeds for your Azure DevOps projects.
+
+
+## Prerequisites
+
+**CLI Version:** 2.81.0
+
+```bash
+# Install Azure DevOps extension
+az extension add --name azure-devops
+```
+
+## Guidelines
+
+See [REFERENCE.md](references/REFERENCE.md) for specific commands to publish and download universal packages.

skills/azure-devops-cli-artifacts/references/REFERENCE.md

@@ -0,0 +1,37 @@
+# Universal Packages
+
+- [Universal Packages](#universal-packages)
+  - [List Feeds](#list-feeds)
+  - [Publish Package](#publish-package)
+  - [Download Package](#download-package)
+
+## List Feeds
+
+Note: The command group `az artifacts feed` is not available in the current azure-devops extension.
+Use the DevOps REST wrapper instead to list feeds.
+
+```bash
+az devops invoke --area packaging --resource feeds --output json
+```
+
+## Publish Package
+
+```bash
+az artifacts universal publish \
+  --feed {feed-name} \
+  --name {package-name} \
+  --version {version} \
+  --path {package-path} \
+  --project {project}
+```
+
+## Download Package
+
+```bash
+az artifacts universal download \
+  --feed {feed-name} \
+  --name {package-name} \
+  --version {version} \
+  --path {download-path} \
+  --project {project}
+```

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

@@ -0,0 +1,25 @@
+---
+name: azure-devops-cli-boards
+description: Manage Azure Boards work items, queries, areas, and iterations with the CLI.
+---
+
+## When to Use This Skill
+
+- You want to create, update, or query Azure Boards work items using the CLI.
+- You need to manage areas and iterations for your Azure DevOps projects and teams.
+
+## Prerequisites
+
+- CLI Version: 2.81.0
+
+```bash
+# Install Azure DevOps extension
+az extension add --name azure-devops
+
+# Optional: set defaults to avoid repeating org/project
+az devops configure --defaults organization=https://dev.azure.com/{org} project={project}
+```
+
+## Guidelines
+- Use the reference commands in [REFERENCE.md](references/REFERENCE.md) for specific work item, area, and iteration management tasks.
+- Area/iteration paths are absolute (for example, `\Project\Area\Team` and `\Project\Iteration\Sprint 1`).