Copilot Sync Skill

Synchronize GitHub Copilot configuration files from the base template to existing codebases.

Triggers

Activate this skill when user mentions:

• •"sync copilot", "copilot sync"
• •"update copilot files", "update copilot configuration"
• •"sync copilot config", "sync configuration"
• •"bring project up to date with copilot"
• •"#copilot-sync"

Description

The Copilot Sync skill synchronizes all Copilot-related files from the github-copilot-base template to an existing codebase:

1. •Agents - All .github/agents/*.md files
2. •Prompts - All .github/prompts/*.prompt.md files
3. •Skills - All .github/skills/*/ directories
4. •Instructions - .github/copilot-instructions.md
5. •PRP Framework - PRPs/ templates
6. •Supporting Docs - Background workflow, style guides

Key Features:

• •💾 Automatic backups before overwriting
• •👁️ Dry-run mode for previewing changes
• •✅ Validation of target repository
• •📊 Detailed sync statistics

Workflow Steps

1. Gather Information

Collect the following using ask_user:

2. Validate Target

# Check path exists
if (-not (Test-Path $TargetPath -PathType Container)) {
    Write-Error "Path does not exist"
}

# Check it's a Git repository
if (-not (Test-Path (Join-Path $TargetPath ".git"))) {
    Write-Error "Not a Git repository"
}

3. Execute Sync

Dry Run (Preview):

$TemplateRepo = "E:\Repos\HouseGarofalo\github-copilot-base"
& "$TemplateRepo\scripts\sync-copilot.ps1" -TargetPath $TargetPath -DryRun

Apply Changes:

$TemplateRepo = "E:\Repos\HouseGarofalo\github-copilot-base"
& "$TemplateRepo\scripts\sync-copilot.ps1" -TargetPath $TargetPath

Force (No Prompts):

& "$TemplateRepo\scripts\sync-copilot.ps1" -TargetPath $TargetPath -Force

4. Post-Sync Guidance

After sync, guide user to:

1. •Review copilot-instructions.md - Add project-specific context
2. •Check backups - In .copilot-backup/ folder
3. •Commit changes:
   powershell

   git add .github PRPs docs
   git commit -m "chore: sync Copilot configuration from github-copilot-base"
   

5. Output Summary

Provide completion summary with:

• •Files synced count
• •New files count
• •Backups created
• •Next steps

What Gets Synced

Options

Backup & Recovery

Backup Location:

<target>\.copilot-backup\
├── .github\
│   ├── copilot-instructions.md.<timestamp>.backup
│   └── agents\*.backup
└── PRPs\*.backup

Restore a File:

Copy-Item "<backup_file>" "<original_path>" -Force

Error Handling

Prerequisites

• •Git installed
• •Target must be an existing Git repository
• •Write access to target directory

Example

User: #copilot-sync E:\Repos\MyOrg\my-project

Copilot: 🔄 Copilot Sync

Validating target... ✅
Target is a Git repository... ✅

Would you like to preview changes first?
> Yes

📋 Dry Run:
   Would sync: 150 files
   New: 45 | Updated: 105

Apply changes?
> Yes

Syncing... ✅
Backing up existing files... ✅

🎉 Sync Complete!
   Files synced: 150
   Backups: .copilot-backup/

Next steps:
1. Review .github/copilot-instructions.md
2. Commit changes

Related

• •Copilot Sync Agent
• •Copilot Sync Prompt
• •Sync Script
• •Project Wizard - For new projects