migrate

Migrate groundrules-bootstrapped projects to the latest plugin version using Git commands.

2|Updated May 11, 2026
One-click install
npx skills add https://github.com/lozit/groundrules --skill migrate-lozit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate
Source: https://github.com/lozit/groundrules/tree/main/skills/migrate
Command: npx skills add https://github.com/lozit/groundrules --skill migrate-lozit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The migrate skill ensures that a groundrules-bootstrapped project, including legacy starter-kits, is up-to-date with the current version of the groundrules plugin, facilitating a smooth transition between versions without overwriting any existing content.

Core Features & Use Cases

  • Version Checking: Compares the installed plugin version against the latest version and prompts for update if necessary.
  • Legacy Project Compatibility: Detects and updates legacy .starter-kit.json files to the new .groundrules.json format.
  • Change Log Analysis: Displays the changes introduced in each new version for the user's understanding.
  • File Renaming and Updating: Automatically updates template-generated files, handles file renames/moves, and provides options for manual intervention if needed.
  • Quick Start: Run /groundrules:migrate to start the migration process for a project.

Quick Start

Update your groundrules-bootstrapped project to the latest plugin version using the /groundrules:migrate command.

Frequently Asked Questions about migrate

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

FAQPage Schema
How do I update my project to the latest groundrules plugin version?

To update your project to the latest groundrules plugin version, run the /groundrules:migrate command, which automates version compatibility checks, file updates, and change log analysis for a smooth transition.

How do I migrate a legacy starter-kit to the new groundrules format?

Migrating a legacy starter-kit involves automatically detecting and updating the old .starter-kit.json file to the new .groundrules.json format using the migrate command, ensuring compatibility with the current plugin.

Does the groundrules migration overwrite my existing project files?

No, the groundrules migration process facilitates a smooth transition between plugin versions without overwriting any existing content, automatically handling template-generated file renames and updates.

How does version checking work for groundrules plugin updates?

Version checking compares the installed groundrules plugin version against the latest available version and prompts for an update if necessary, displaying the change log so you understand the introduced changes.

Can I manually intervene when template-generated files are renamed during migration?

Yes, when the migration process automatically updates and handles file renames or moves for template-generated files, it provides options for manual intervention if needed.

Do I need Git to run the groundrules plugin migration?

Yes, the migration process utilizes Git commands and plugin metadata to automate updating groundrules-bootstrapped projects, requiring Git for proper version control and file updates.