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:
   powershellCopy

   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