Miferrac/azdoskills-refactor #683

phenixita · 2026-02-08T10:22:23Z

Pull Request Checklist

I have read and followed the CONTRIBUTING.md guidelines.
My contribution adds a new instruction, prompt, agent, or skill file in the correct directory.
The file follows the required naming convention.
The content is clearly structured and follows the example format.
I have tested my instructions, prompt, agent, or skill with GitHub Copilot.
I have run npm start and verified that README.md is up to date.

Description

This PR splits the monolithic azure devops skill into dedicated "single responsability" skills for each product area (work items, pipeline, wiki...) for efficient use of context.

Type of Contribution

Additional Notes

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

Introduce focused Azure DevOps CLI skill modules and command references. Adds SKILL.md and references/REFERENCE.md for admin, artifacts, boards (includes scripts/script.md), core devops, pipelines, repos, security, service-endpoint, teams, users, and wiki with usage guidelines, common workflows, and example az CLI commands (requires azure-devops extension, CLI v2.81.0 noted). Removes the old aggregated skills/azure-devops-cli/SKILL.md.

Refresh and correct Azure DevOps CLI skill documentation and reference examples across multiple modules. Key changes: add note and example to list Universal Package feeds; add az devops configure defaults and guidance for boards; fix board area/iteration absolute paths, show relations example, and add troubleshooting tips; update devops login examples to recommend piping PAT and PowerShell usage; standardize security commands to use --namespace-id and --subject and switch permission flags to allow/deny/bit usage; change team delete to use --id; normalize user org URL formatting and email flag; refine wiki skill header, set wiki type values to lowercase, add page show recursion and version/etag example. These edits improve accuracy, security, and usability of CLI examples.

Copilot

Pull request overview

Refactors the existing monolithic Azure DevOps CLI skill into multiple smaller, single-responsibility skills organized by Azure DevOps product area to reduce context size and improve targeted usage.

Changes:

Removes the monolithic azure-devops-cli skill.
Adds dedicated skills for admin, artifacts, boards, core devops, pipelines, repos, security, service endpoints, teams, users, and wiki.
Updates docs/README.skills.md to list the new skills and their bundled assets.

Reviewed changes

Copilot reviewed 25 out of 25 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
skills/azure-devops-cli/SKILL.md	Removes the previous monolithic Azure DevOps CLI skill content.
skills/azure-devops-cli-admin/SKILL.md	Adds a dedicated admin-focused skill entry point.
skills/azure-devops-cli-admin/references/REFERENCE.md	Adds admin command reference (defaults, banners, marketplace extensions).
skills/azure-devops-cli-artifacts/SKILL.md	Adds an artifacts-focused skill entry point.
skills/azure-devops-cli-artifacts/references/REFERENCE.md	Adds universal packages reference commands and notes about feeds.
skills/azure-devops-cli-boards/SKILL.md	Adds a boards-focused skill entry point.
skills/azure-devops-cli-boards/references/REFERENCE.md	Adds work item / area / iteration command references.
skills/azure-devops-cli-boards/scripts/script.md	Adds a helper script snippet for idempotent work item creation.
skills/azure-devops-cli-devops/SKILL.md	Adds a core “devops CLI setup/auth” skill entry point.
skills/azure-devops-cli-devops/references/REFERENCE.md	Adds core CLI usage reference (auth, configure, projects, output, queries).
skills/azure-devops-cli-pipelines/SKILL.md	Adds a pipelines-focused skill entry point.
skills/azure-devops-cli-pipelines/references/REFERENCE.md	Adds pipelines command references and workflows.
skills/azure-devops-cli-repos/SKILL.md	Adds a repos-focused skill entry point.
skills/azure-devops-cli-repos/references/REFERENCE.md	Adds repos/PR/policy reference commands and workflows.
skills/azure-devops-cli-security/SKILL.md	Adds a security-focused skill entry point.
skills/azure-devops-cli-security/references/REFERENCE.md	Adds security groups and permissions reference commands.
skills/azure-devops-cli-service-endpoint/SKILL.md	Adds a service endpoint/connection-focused skill entry point.
skills/azure-devops-cli-service-endpoint/references/REFERENCE.md	Adds service endpoint reference commands and idempotent function example.
skills/azure-devops-cli-teams/SKILL.md	Adds a teams-focused skill entry point.
skills/azure-devops-cli-teams/references/REFERENCE.md	Adds teams reference commands.
skills/azure-devops-cli-users/SKILL.md	Adds a users-focused skill entry point.
skills/azure-devops-cli-users/references/REFERENCE.md	Adds users reference commands.
skills/azure-devops-cli-wiki/SKILL.md	Adds a wiki-focused skill entry point.
skills/azure-devops-cli-wiki/references/REFERENCE.md	Adds wiki and wiki page reference commands.
docs/README.skills.md	Replaces the single monolithic skill entry with multiple dedicated skill entries.

Copilot · 2026-02-08T12:47:05Z

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

+az devops wiki create \
+  --name {wiki-name} \
+  --project {project} \
+  --type projectwiki


The az devops wiki create --type values look incorrect (projectwiki / codewiki). The Azure DevOps CLI expects specific enum values (commonly projectWiki and codeWiki), and using the wrong values will cause the command to fail. Update these examples to the correct --type values supported by the CLI.

Copilot · 2026-02-08T12:47:05Z

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

+az devops wiki create \
+  --name {wiki-name} \
+  --project {project} \
+  --type codewiki \
+  --repository {repo-name} \
+  --mapped-path /wiki \
+  --version {branch-name}


The az devops wiki create --type values look incorrect (projectwiki / codewiki). The Azure DevOps CLI expects specific enum values (commonly projectWiki and codeWiki), and using the wrong values will cause the command to fail. Update these examples to the correct --type values supported by the CLI.

Copilot · 2026-02-08T12:47:06Z

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

+
+```bash
+# Count items by status
+az pipelines runs list --query "groupBy([?status=='completed'], &[result]) | {Succeeded: [?key=='succeeded'][0].count, Failed: [?key=='failed'][0].count}"


The JMESPath expression uses groupBy(...), which is not part of the standard JMESPath functions supported by the Azure CLI, so this example will fail when run. Replace this with a supported approach (for example, computing counts with length([...]) filters, or remove the example if it can’t be expressed portably).

Suggested change

az pipelines runs list --query "groupBy([?status=='completed'], &[result]) | {Succeeded: [?key=='succeeded'][0].count, Failed: [?key=='failed'][0].count}"

az pipelines runs list --query "{Succeeded: length([?status=='completed' && result=='succeeded']), Failed: length([?status=='completed' && result=='failed'])}"

Copilot · 2026-02-08T12:47:06Z

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

+    - [Create Pull Request](#create-pull-request)
+    - [List Pull Requests](#list-pull-requests)
+    - [Show PR Details](#show-pr-details)
+    - [Update PR (Complete/Abandon/Draft)](#update-pr-completeabandondraft)


These TOC anchor links are not consistent with GitHub’s heading slug generation for the referenced sections (they likely won’t resolve). Consider either (1) regenerating the anchors to match GitHub’s slugs, or (2) replacing the manual TOC with a simpler structure / fewer deep links to avoid drift.

Suggested change

- [Update PR (Complete/Abandon/Draft)](#update-pr-completeabandondraft)

- [Update PR (Complete/Abandon/Draft)](#update-pr-complete-abandon-draft)

Copilot · 2026-02-08T12:47:06Z

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

+  - [Repository Policies](#repository-policies)
+    - [List All Policies](#list-all-policies)
+    - [Create Policy Using Configuration File](#create-policy-using-configuration-file)
+    - [Update/Delete Policy](#updatedelete-policy)


These TOC anchor links are not consistent with GitHub’s heading slug generation for the referenced sections (they likely won’t resolve). Consider either (1) regenerating the anchors to match GitHub’s slugs, or (2) replacing the manual TOC with a simpler structure / fewer deep links to avoid drift.

Suggested change

- [Update/Delete Policy](#updatedelete-policy)

- Update/Delete Policy

Copilot · 2026-02-08T12:47:06Z

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

+# DevOps Cli
+
+- [DevOps Cli](#devops-cli)


“Cli” should be capitalized as “CLI” for consistency with common terminology and the rest of the docs.

Suggested change

# DevOps Cli

- [DevOps Cli](#devops-cli)

# DevOps CLI

- [DevOps CLI](#devops-cli)

aaronpowell · 2026-02-09T00:33:16Z

Can you review the comments from Copilot and either action or dismiss if they aren't relevant.

phenixita added 5 commits February 8, 2026 11:17

Refactor README to enhance clarity and add Azure DevOps CLI skills

9a6712f

Refresh

d865938

Remove azure-devops-analytics skill documentation from README

c1d95c8

phenixita marked this pull request as ready for review February 8, 2026 12:45

Copilot AI review requested due to automatic review settings February 8, 2026 12:45

Copilot AI reviewed Feb 8, 2026

View reviewed changes

aaronpowell approved these changes Feb 9, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Miferrac/azdoskills-refactor #683

Miferrac/azdoskills-refactor #683

phenixita commented Feb 8, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Feb 8, 2026

Uh oh!

Copilot AI Feb 8, 2026

Uh oh!

Copilot AI Feb 8, 2026

Uh oh!

Copilot AI Feb 8, 2026

Uh oh!

Copilot AI Feb 8, 2026

Uh oh!

Copilot AI Feb 8, 2026

Uh oh!

aaronpowell commented Feb 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	az pipelines runs list --query "groupBy([?status=='completed'], &[result]) \| {Succeeded: [?key=='succeeded'][0].count, Failed: [?key=='failed'][0].count}"
	az pipelines runs list --query "{Succeeded: length([?status=='completed' && result=='succeeded']), Failed: length([?status=='completed' && result=='failed'])}"

	- [Update PR (Complete/Abandon/Draft)](#update-pr-completeabandondraft)
	- [Update PR (Complete/Abandon/Draft)](#update-pr-complete-abandon-draft)

	- [Update/Delete Policy](#updatedelete-policy)
	- Update/Delete Policy

Miferrac/azdoskills-refactor #683

Are you sure you want to change the base?

Miferrac/azdoskills-refactor #683

Conversation

phenixita commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Pull Request Checklist

Description

Type of Contribution

Additional Notes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

aaronpowell commented Feb 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

phenixita commented Feb 8, 2026 •

edited

Loading