Add role skill

[tmeschter]

Pull Request Checklist

• I have read and followed the CONTRIBUTING.md guidelines.
• My contribution adds a new instruction, prompt, or chat mode 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, or chat mode with GitHub Copilot.
• I have run npm start and verified that README.md is up to date.

---

Description

Add a new skill to select the proper role for specific Azure scenarios.

---

Type of Contribution

• New instruction file.
• New prompt file.
• New chat mode file.
• New collection file.
• Update to existing instruction, prompt, chat mode, or collection.
• Other (please specify): New skill

---

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.

[Copilot]

Pull request overview

This PR adds a new agent skill called "azure-role-selector" that helps users select and assign appropriate Azure roles to identities based on desired permissions, following the principle of least privilege access.

Key Changes

• New skill folder structure with SKILL.md and LICENSE.txt files
• Integration of Azure MCP tools for role discovery, CLI generation, and Bicep code generation
• Documentation update to register the new skill in the skills catalog

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File	Description
skills/azure-role-selector/SKILL.md	Defines the skill metadata and instructions for Azure role selection using MCP tools
skills/azure-role-selector/LICENSE.txt	Adds MIT license for the skill
docs/README.skills.md	Registers the new skill in the skills documentation table

[Copilot]

Add a space after "identity" and before the opening parenthesis to improve readability.

Suggested change

Use 'Azure MCP/documentation' tool to find the minimal role definition that matches the desired permissions the user wants to assign to an identity(If no built-in role matches the desired permissions, use 'Azure MCP/extension_cli_generate' tool to create a custom role definition with the desired permissions). Use 'Azure MCP/extension_cli_generate' tool to generate the CLI commands needed to assign that role to the identity and use the 'Azure MCP/bicepschema' and the 'Azure MCP/get_bestpractices' tool to provide a Bicep code snippet for adding the role assignment.

Use 'Azure MCP/documentation' tool to find the minimal role definition that matches the desired permissions the user wants to assign to an identity (If no built-in role matches the desired permissions, use 'Azure MCP/extension_cli_generate' tool to create a custom role definition with the desired permissions). Use 'Azure MCP/extension_cli_generate' tool to generate the CLI commands needed to assign that role to the identity and use the 'Azure MCP/bicepschema' and the 'Azure MCP/get_bestpractices' tool to provide a Bicep code snippet for adding the role assignment.

[Copilot]

The description in the table should be concise and human-readable, not the full technical instructions from the SKILL.md file. Consider using the description from the front matter instead, similar to how the webapp-testing skill presents its description.

Suggested change

| [azure-role-selector](../skills/azure-role-selector/SKILL.md) | Use 'Azure MCP/documentation' tool to find the minimal role definition that matches the desired permissions the user wants to assign to an identity(If no built-in role matches the desired permissions, use 'Azure MCP/extension_cli_generate' tool to create a custom role definition with the desired permissions). Use 'Azure MCP/extension_cli_generate' tool to generate the CLI commands needed to assign that role to the identity and use the 'Azure MCP/bicepschema' and the 'Azure MCP/get_bestpractices' tool to provide a Bicep code snippet for adding the role assignment. | `LICENSE.txt` |

| [azure-role-selector](../skills/azure-role-selector/SKILL.md) | Helps you identify the minimal Azure role that matches requested permissions and generates role assignment commands and Bicep snippets. | `LICENSE.txt` |

[digitarald]

Please address Copilot code review comments