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 node update-readme.js and verified that README.md is up to date.

Description

This PR introduces a new file: instructions/powershell.instructions.md, providing guidance for effective use of GitHub Copilot with PowerShell. The PowerShell instructions file is structured to align with Microsoft's cmdlet development guidelines and the existing format of this repository. It includes:

• Naming conventions (verb-noun, PascalCase, parameter and variable naming)
• Cmdlet parameter design (including [switch], validation, -PassThru, and ValueFromPipeline)
• Proper use of the pipeline, output practices, and structured object emission
• Idiomatic error handling using ShouldProcess, Write-* streams, try/catch, and non-interactive design
• Style guidance including formatting, alias avoidance, comment-based help, and automation-friendly structure
• Several code examples and a full end-to-end cmdlet implementation pattern

Changes

• Added: instructions/powershell.instructions.md
• Updated: readme.md

References

• Based on: PowerShell Strongly Encouraged Development Guidelines (Microsoft Docs)

Type of Contribution

• New instruction file.
• New prompt file.
• New chat mode file.
• Other (please specify):

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