migrate-to-claude-code

Migrate an existing repository to Claude Code workflow and conventions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/cychen2021/claude-skills --skill migrate-to-claude-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-to-claude-code
Source: https://github.com/cychen2021/claude-skills/tree/main/migrate-to-claude-code
Command: npx skills add https://github.com/cychen2021/claude-skills --skill migrate-to-claude-code

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) components.

What problem does it solve?

Migrate an existing repository to adopt Claude Code workflow and conventions, enabling structured documentation, checkpoint management, and standardized project setup.

Core Features & Use Cases

  • Create a docs/ and checkpoints/ directory with a clear documentation pattern to streamline onboarding.
  • Generate CLAUDE.md at the repository root to capture project conventions, development workflow, and code style guidance.
  • Configure .vscode/settings.json to enable Claude Code and optional Copilot integration, plus migration-friendly settings.
  • Migrate or remove copilot-instructions submodule and adjust Git configuration as needed.
  • Provide post-migration validation steps and templates for consistent future projects.

Quick Start

Run through the migration steps to set up CLAUDE.md, docs/ structure, .vscode settings, and checkpoints for an existing repository.

Frequently Asked Questions about migrate-to-claude-code

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate an existing repository to Claude Code workflow and conventions?

To migrate an existing repository to Claude Code, you run structured migration steps that generate a CLAUDE.md file, create a docs/ and checkpoints/ directory structure, and configure VSCode settings for a safe transition.

What is the best way to set up CLAUDE.md and documentation directories for a new project?

Generating CLAUDE.md and a docs/ structure captures project conventions, development workflow, and code style guidance. Using templates streamlines onboarding and ensures consistent future project setup.

Can I configure VSCode settings for Claude Code and Copilot integration during migration?

Yes, the migration process configures .vscode/settings.json to enable Claude Code and optional Copilot integration. It applies migration-friendly settings to ensure the development workflow functions correctly within VSCode.

How do I handle the copilot-instructions submodule when moving to Claude Code?

To handle the copilot-instructions submodule during migration, you can migrate or remove the submodule and adjust Git configuration as needed. This ensures a clean transition to Claude Code conventions.

Does Claude Code migration include post-migration validation steps?

Yes, the migration provides post-migration validation steps and templates. These verification steps ensure a safe migration to the Claude Code workflow and support consistent setup for future projects.