Will my internal documentation links break during migration?

The migration includes an LLM-based link correction phase that understands the context of your files to intelligently update relative paths, ensuring link integrity in the new structure.

How does the AI-powered categorization work?

The skill uses the Gemini CLI to analyze the actual content of your documents rather than just their filenames, allowing it to accurately identify specs, proposals, and ADRs.

What are the prerequisites for using the Project Migrate skill?

You need a Git-initialized repository, the Gemini CLI tool installed and authenticated, and the doc-indexer skill available for final validation.

Does this skill delete my original documentation files?

No. The skill uses 'git mv' to move files into the new structure, preserving your history, and creates a full timestamped backup with a rollback script before any changes are made.

Project Migration Assistant

Name: Project Migration Assistant
Author: bodangren

bybodangren

•

Learning & Documentation

Migrates existing project documentation into the AgenticDev structure using AI-powered analysis and intelligent link correction.

The Project Migrate skill automates the transition of brownfield projects into the standardized AgenticDev directory structure, creating an AI-ready documentation environment. By leveraging the Gemini CLI, the skill goes beyond simple file moves to intelligently categorize markdown files based on their actual content, generate rich YAML frontmatter, and perform context-aware link updates. With a safety-first workflow that includes interactive approval phases, automated backups, and Git history preservation, it provides a seamless and risk-free way to modernize legacy project documentation workflows.

Key Features

01Rich YAML frontmatter generation for enhanced document indexing and search

02Intelligent LLM-based relative link correction and context-aware updates

03Automated Git history preservation through integrated git mv operations

049 GitHub stars

05AI-powered document discovery and categorization using Gemini CLI

06Safe-guarded workflow with dry-run modes, full backups, and rollback scripts

Use Cases

01Standardizing documentation for legacy repositories to follow the AgenticDev format

02Restructuring project directories while maintaining link integrity and Git history

03Automating the generation of metadata and descriptions for large markdown collections

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bodangren/git-workflow project-migrate

For use in Claude.ai and ChatGPT

Download Skill