Agent Skills: AI Dev Tools Sync

AI Dev Tools Sync

Synchronize Claude Code and GitHub Copilot configurations to maintain feature parity.

Summary

Goal: Synchronize Claude Code and GitHub Copilot configurations to maintain feature parity across both AI development tools.

| Step | Action | Key Notes | |------|--------|-----------| | 1 | Identify change scope | Skills, prompts, agents, instructions, or workflows | | 2 | Map equivalents | Claude SKILL.md <-> Copilot prompt.md, etc. | | 3 | Apply changes | Update both platforms' config files | | 4 | Verify parity | Ensure both tools have matching capabilities |

Key Principles:

• Claude skills live in .claude/skills/, Copilot prompts in .github/prompts/
• Copilot auto-reads Claude skills — avoid duplication where possible
• Agents are shared in .github/agents/ for both platforms

When to Use

Activate this skill when:

• User asks to update Claude Code or Copilot setup
• User wants to add/modify skills, prompts, agents, or instructions
• User wants both tools to work similarly
• User asks about AI dev tool configuration

Quick Reference

| Claude Code | GitHub Copilot | Location | | -------------- | ----------------------- | ------------------------------------------ | | SKILL.md | SKILL.md | .claude/skills/ + .github/skills/ | | skills//SKILL.md | prompts/.prompt.md | .claude/skills/ + .github/prompts/ | | agents/.md | agents/.md | .github/agents/ (shared) | | workflows/.md | - | .claude/workflows/ | | CLAUDE.md | copilot-instructions.md | Root + .github/ | | - | instructions/.md | .github/instructions/ (applyTo patterns) | | - | chatmodes/*.chatmode.md | .github/chatmodes/ |

GitHub Copilot Features Catalog

Complete catalog of GitHub Copilot customization features (as of 2026).

Configuration Files

Repository-Level (.github/)

| File/Folder | Purpose | Format | | --- | --- | --- | | copilot-instructions.md | Global instructions for all Copilot interactions | Markdown | | instructions/*.instructions.md | Path-scoped instructions with applyTo frontmatter | Markdown + YAML | | prompts/*.prompt.md | Reusable prompts (slash commands) | Markdown + YAML | | agents/*.md | Agent definitions | Markdown + YAML | | skills/*/SKILL.md | Agent skills with bundled resources | Markdown + YAML | | chatmodes/*.chatmode.md | Custom chat personalities | Markdown + YAML | | AGENTS.md | Master agent routing file | Markdown |

Also Supported (Backward Compatibility)

• .claude/skills/ - Copilot auto-reads Claude skills
• CLAUDE.md - Copilot reads if present
• GEMINI.md - Gemini CLI format

Feature Details

Custom Instructions (copilot-instructions.md)

Root instructions auto-included in every request.

# Project Guidelines
- Use TypeScript for all new files
- Follow BEM naming for CSS classes

Path-Scoped Instructions (.github/instructions/)

Apply to specific file patterns via applyTo:

---
applyTo: "src/Services/**/*.cs"
excludeAgent: ["code-review"] # Optional: exclude specific agents
---
# Backend C# Guidelines
Use PlatformValidationResult for validation...

Prompts (.github/prompts/)

Reusable via /prompt-name in chat:

---
mode: agent # Optional: agent, chat, edit
---
# Debug this issue
1. Analyze the error
2. Find root cause
3. Propose fix

Agent Skills (.github/skills/)

Folder structure with SKILL.md + bundled resources:

skills/my-skill/
├── SKILL.md
├── scripts/
├── references/
└── assets/

Chat Modes (.github/chatmodes/)

Custom chat personalities with tool restrictions:

---
name: security-reviewer
tools: ["read", "grep", "glob"] # Restrict tools
---
# Security Review Mode
Focus only on security vulnerabilities...

Agents (.github/agents/)

Specialized agent definitions:

---
name: frontend-developer
description: UI/UX implementation specialist
---
# Frontend Developer Agent
Specializes in React, TypeScript, CSS...

Sync Patterns

Patterns for keeping Claude Code and GitHub Copilot configurations synchronized.

Skill Sync

Both platforms support skills in .github/skills/. Copilot also reads .claude/skills/.

Best Practice: Create skills in .github/skills/ for maximum compatibility.

.github/skills/my-skill/
├── SKILL.md          # Both platforms read
├── scripts/          # Executable scripts
├── references/       # Progressive disclosure docs
└── assets/           # Templates, images

Prompt/Command Sync

| Claude Code | GitHub Copilot | | ---------------------------- | ------------------------------------------ | | .claude/skills/my-cmd.md | .github/prompts/my-cmd.prompt.md | | Invoked via /my-cmd | Invoked via /my-cmd or #prompt:my-cmd |

Sync Strategy:

1. Create in .github/prompts/ (both read)
2. Or maintain duplicates if behavior differs

Instructions Sync

| Claude Code | GitHub Copilot | | ------------------- | ----------------------------------- | | CLAUDE.md (root) | .github/copilot-instructions.md | | Single file | Multi-file with applyTo patterns |

Sync Strategy:

1. Keep core rules in both files
2. Use .github/instructions/ for path-scoped rules (Copilot-specific)
3. Reference detailed docs from both files

Agent Sync

Both platforms read .github/agents/*.md.

Single Source: Maintain agents in .github/agents/ only.

Workflow Sync

Claude has workflow orchestration. Copilot uses chat modes.

| Claude Workflow | Copilot Equivalent | | ------------------------ | -------------------- | | Sequential agent chains | Chat mode switching | | .claude/workflows/ | .github/chatmodes/ |

Decision Matrix

| Feature | Location | Reason | | --- | --- | --- | | Skills | .github/skills/ | Maximum compatibility | | Prompts | .github/prompts/ | Both platforms read | | Agents | .github/agents/ | Shared location | | Instructions | Both files | Platform-specific nuances | | Workflows | .claude/workflows/ | Claude-specific | | Chat Modes | .github/chatmodes/ | Copilot-specific |

Common Sync Tasks

Add New Skill

mkdir -p .github/skills/new-skill
# Create SKILL.md with frontmatter
# Add references/ and scripts/ as needed

Add New Prompt

# Create in .github/prompts/ for both platforms
touch .github/prompts/new-prompt.prompt.md

Update Core Instructions

1. Edit CLAUDE.md
2. Edit .github/copilot-instructions.md
3. Keep essential rules in sync

Add Path-Scoped Instructions (Copilot)

# Copilot-specific feature
touch .github/instructions/backend-cqrs.instructions.md
# Add applyTo: "src/Services/**/*Command*.cs"

Sync Process

Step 1: Understand Current Setup

Read these files to understand current configuration:

.claude/workflows/orchestration-protocol.md
.claude/workflows/primary-workflow.md
.github/copilot-instructions.md
.github/AGENTS.md
CLAUDE.md

Step 2: Research Latest Features

Search web for:

• "GitHub Copilot features setup 2026"
• "GitHub Copilot custom instructions agents skills prompts"
• "GitHub Copilot agent mode workspace context"

See the GitHub Copilot Features Catalog section above for the full feature catalog.

Step 3: Identify Sync Opportunities

Compare capabilities and identify gaps:

• Skills missing in one platform
• Inconsistent prompt/instruction behavior
• Agent definitions that differ

Step 4: Implement Changes

For each change:

1. Skills: Create in both .claude/skills/ and .github/skills/
2. Prompts: Create in both .claude/skills/ and .github/prompts/
3. Instructions: Update both CLAUDE.md and .github/copilot-instructions.md
4. Agents: Update .github/agents/ (shared by both)

Compatibility Notes

• Copilot reads .claude/skills/ automatically (backward compatibility)
• Both read .github/prompts/*.prompt.md
• Both read .github/agents/*.md
• Both read AGENTS.md in root or .github/
• Both support path-based instruction files via applyTo in frontmatter

Sources

• GitHub Copilot Docs
• Custom Instructions
• Agent Skills
• Awesome Copilot

IMPORTANT Task Planning Notes

• Always plan and break many small todo tasks
• Always add a final review todo task to review the works done at the end to find any fix or enhancement needed