How-to Guide: Install Copilot Assets in Your Repo

This guide explains how to install the Copilot agents, skills, prompts, and instructions from this repository into your own project.

  1. Copy Install-CopilotAssets.ps1 and a config file (see copilot-packs/ for examples) into your target repo.
  2. (Optional) Add a nameTransform object to any source entry in your config to apply a prefix, suffix, or frontmatter update to installed asset names. This helps avoid filename collisions and makes it clear which repo an asset came from, without renaming the canonical source files. See Reference: Copilot Asset Installation & Name Transform for details and examples.
  3. Run: 
    ./Install-CopilotAssets.ps1 -TargetFolder <your-repo> -ConfigFile <config.json>
  4. The script will copy the specified agents, skills, prompts, and instructions into .github/, applying any configured name transforms.

By default, source repositories are cloned into a per-user cache at ~/.copilot-assets-cache. To use a different location, pass -CloneRoot <path>.

Manual Installation

  1. Copy the following folders from this repo to your target repo:
    • .github/agents/
    • .github/skills/
    • .github/prompts/
    • .github/instructions/
  2. Adjust any paths or references as needed.

Next Steps