Skip to content

README.md

Latest commit

 

History

History
49 lines (33 loc) · 2.4 KB

README.md

File metadata and controls

49 lines (33 loc) · 2.4 KB
Raw

Custom Copilot Prompts

This directory contains reusable prompt files that extend Copilot Chat with repeatable tasks (e.g., "Write ADR", "Write PRD"). Prompts standardize how assistants operate, capture inputs, and produce consistent outputs.

Custom prompts in this repository

How to use

  • In Copilot Chat, type the prompt name or pick it from the quick actions list.
  • Many prompts can be invoked like a slash command (e.g., /write-adr). If your IDE surfaces prompt files differently, open the prompt and follow its inputs section.
  • Provide required inputs when asked (see the Inputs section inside each prompt). Defaults are applied when permitted.

Creating a new prompt

  • Copy an existing .prompt.md file as a starting point.
  • Set a clear description and the minimal tools needed.
  • Add an Inputs section with ${input:...} placeholders and validation rules.
  • Define output structure and quality gates so results are consistent and reviewable.

Referencing skills from prompts

Prompts can reference skills to improve workflow selection and keep outputs consistent with repository guidance.

  • Discover available skills in ../skills/README.md.
  • Link the relevant skill in the prompt context section when a workflow is domain-specific.
  • Prefer referencing the skill and SSOT docs instead of duplicating long instructions in the prompt.

Current example skill:

  • docs-ssot-helper for documentation updates aligned with repository SSOT, links, and canonical structure.

Hints

Within a prompt file, you can reference variables by using the ${variableName} syntax. You can reference the following variables:

  • Workspace variables - ${workspaceFolder}, ${workspaceFolderBasename}
  • Selection variables - ${selection}, ${selectedText}
  • File context variables - ${file}, ${fileBasename}, ${fileDirname}, ${fileBasenameNoExtension}
  • Input variables - ${input:variableName}, ${input:variableName:placeholder} (pass values to the prompt from the chat input field)

Official Docs