Skip to content

feat: Add AI Prompt Engineering Safety Best Practices#87

Merged
aaronpowell merged 6 commits into
github:mainfrom
VamshiVerma:main
Jul 13, 2025
Merged

feat: Add AI Prompt Engineering Safety Best Practices#87
aaronpowell merged 6 commits into
github:mainfrom
VamshiVerma:main

Conversation

@VamshiVerma

Copy link
Copy Markdown
Contributor

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 contribution adds comprehensive AI prompt engineering safety best practices to the awesome-copilot repository. I've created two complementary files:

  1. Instruction File (instructions/ai-prompt-engineering-safety-best-practices.instructions.md): A comprehensive guide covering prompt engineering fundamentals, safety frameworks, bias mitigation, security best practices, and responsible AI usage. This instruction provides developers with industry-standard best practices for creating safe, effective, and responsible AI prompts.

  2. Prompt File (prompts/ai-prompt-engineering-safety-review.prompt.md): An actionable prompt for systematically reviewing and improving other prompts. This prompt includes analysis frameworks, safety assessment criteria, bias detection methodologies, security analysis, and testing recommendations.

Both files are designed to work together - the instruction provides the knowledge foundation, while the prompt provides the practical tool for applying those principles. The content is based on industry best practices from Microsoft, OpenAI, Google AI, and other leading organizations in responsible AI development.


Type of Contribution

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

Additional Notes

We need to fill the gap on AI safety and prompt engineering and I noticed this repo was missing guidance on responsible AI practices. The instruction file pulls from Microsoft's docs, OpenAI's guides, and some papers I've been reading on bias detection.

Tested both files with Copilot and they work well - the instruction file helps developers think about safety from the start, and the prompt file is great for reviewing existing prompts. I've used it on a few of my own projects and it caught some issues I hadn't considered.

Made sure to follow the existing naming patterns and checked there weren't any conflicts. The README update worked fine and both files show up correctly.

This should fill a real gap in the repo - I've seen a lot of developers struggle with prompt safety, so having guidance like this should be really helpful.


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

- Add 868-line instruction file covering prompt engineering fundamentals, safety, bias mitigation, security, and responsible AI usage
- Add 527-line expert chat mode for prompt analysis and improvement with systematic evaluation frameworks
- Include detailed templates, checklists, examples, and educational resources
- Follow industry best practices from Microsoft, OpenAI, and Google AI principles
- Implement comprehensive safety assessment frameworks and bias detection tools
- Add advanced techniques: prompt chaining, templates, versioning, and testing frameworks
- Provide extensive references to official guidelines, research papers, and community resources
- Strictly comply with project guidelines (CONTRIBUTING.md, SECURITY.md, SUPPORT.md)

Total: 1,395 lines of professional-grade prompt engineering guidance
…nstruction

- Add 868-line comprehensive instruction file covering prompt engineering fundamentals
- Include safety frameworks, bias mitigation, security best practices, and responsible AI usage
- Provide detailed templates, checklists, and testing methodologies
- Cover anti-patterns, prompt injection prevention, and ethical considerations
- Add educational content on prompt patterns, validation techniques, and documentation
- Include practical examples and real-world scenarios for developers
- Rename file to avoid conflict with existing prompt-engineer chat mode
- Update README with new instruction file

This instruction provides developers with industry-standard best practices for creating safe, effective, and responsible AI prompts for Copilot and other LLMs.
- Restore the original prompt-engineer.chatmode.md from upstream/main
- Remove overwritten comprehensive version to avoid duplication and conflict
- Ensure only the official, simple prompt engineer chat mode is present

All advanced prompt engineering best practices are now in the new instruction file only.
…t mode

- Re-run update-readme.js to ensure only the correct, original description for prompt-engineer.chatmode.md is present
- Remove any duplicate or outdated descriptions from previous comprehensive version
- README is now fully in sync with the restored chat mode and current repo state
- Add 150+ line prompt file for AI prompt engineering safety review and improvement
- Include systematic analysis framework covering safety, bias, security, and effectiveness
- Provide structured output format with detailed assessment criteria
- Include safety guidelines, testing recommendations, and educational insights
- Complement the existing AI prompt engineering safety best practices instruction
- Follow repository guidelines and best practices for prompt creation

This prompt enables developers to systematically review and improve prompts for safety, bias mitigation, security, and responsible AI usage.
…nsive analysis

- Expand prompt from basic to comprehensive 200+ line analysis framework
- Add advanced pattern analysis covering zero-shot, few-shot, chain-of-thought, role-based patterns
- Include technical robustness assessment (input validation, error handling, scalability)
- Add performance optimization metrics (token efficiency, response quality, consistency)
- Enhance output format with detailed scoring and assessment criteria
- Include bias mitigation strategies, security enhancements, and technical improvements
- Provide extensive testing recommendations and educational insights
- Follow repository guidelines for comprehensive, actionable prompt content

This expanded prompt provides developers with a thorough, systematic approach to prompt safety review and improvement.
@aaronpowell aaronpowell merged commit c321e2a into github:main Jul 13, 2025
2 checks passed
github-actions Bot added a commit that referenced this pull request May 8, 2026
- 00-quick-start: add Optional shell tab completion details section
  (copilot completion bash|zsh|fish commands, persistent setup)
- 04-agents-and-custom-instructions: remove mention that /init generates
  AGENTS.md; keep 'write your own' guidance instead
- Bump lastUpdated to 2026-05-08 for both pages

Upstream commits synced:
- 0ddfebd: docs: update course content with Copilot CLI v1.0.37-v1.0.40 features
- af9965758d61: Refine Copilot CLI course updates
- fbf8db99: Merge PR #109 (remove /init AGENTS.md generation mention)
- 54b2b645: Merge PR #87 (fix formatting in 01-setup-and-first-steps)
- 7c7acb1d: latest SHA

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
aaronpowell pushed a commit that referenced this pull request May 11, 2026
- 00-quick-start: add Optional shell tab completion details section
  (copilot completion bash|zsh|fish commands, persistent setup)
- 04-agents-and-custom-instructions: remove mention that /init generates
  AGENTS.md; keep 'write your own' guidance instead
- Bump lastUpdated to 2026-05-08 for both pages

Upstream commits synced:
- 0ddfebd: docs: update course content with Copilot CLI v1.0.37-v1.0.40 features
- af9965758d61: Refine Copilot CLI course updates
- fbf8db99: Merge PR #109 (remove /init AGENTS.md generation mention)
- 54b2b645: Merge PR #87 (fix formatting in 01-setup-and-first-steps)
- 7c7acb1d: latest SHA

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
aaronpowell added a commit that referenced this pull request May 13, 2026
* chore: publish from staged

* sync: update CLI for Beginners learning hub (2026-05-08)

- 00-quick-start: add Optional shell tab completion details section
  (copilot completion bash|zsh|fish commands, persistent setup)
- 04-agents-and-custom-instructions: remove mention that /init generates
  AGENTS.md; keep 'write your own' guidance instead
- Bump lastUpdated to 2026-05-08 for both pages

Upstream commits synced:
- 0ddfebd: docs: update course content with Copilot CLI v1.0.37-v1.0.40 features
- af9965758d61: Refine Copilot CLI course updates
- fbf8db99: Merge PR #109 (remove /init AGENTS.md generation mention)
- 54b2b645: Merge PR #87 (fix formatting in 01-setup-and-first-steps)
- 7c7acb1d: latest SHA

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* cleaning up plugin folder

* Reverting the readme changes

* Reverting a plugin change

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Aaron Powell <me@aaron-powell.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants