Adding agent skills for project migration 🤖

[DavidVujic]

Since before, there are agent skills included in the polylith-cli that will give agents knowledge about the CLI tool and about Polylith in general. The skills were announced in #445

Today, I released a new version of the polylith-cli that includes additional skills: migrating an existing Python repo into Polylith!

The skills include project conversion and refactoring of existing Python code into bases and components, and conversion of Package & Dependency management tools, linters and type checkers into what is used in the Polylith Monorepo. The skills have been tested by migrating single-service repos into a new Polylith Workspace. During the migration, the skills have been updated with learnings from the migration. All skills are written by agents.

The flow is basically:

discover →
analyze-imports (choose shim/shimless) →
extract-to-base →
update-imports →
prepare-project →
verify-stability →
isolate-base-and-big-component →
split-big-component →
extract-standalone-modules →
isolate-shared-and-project-logic →
distribute-wiring →
split-component-internals →
refactor-tests →
definition-of-done

I have tested the skills with Claude (Opus 4.7, Claude Opus 4.8) and Mistral (mistral-large and devstral). Agents are unpredictable and different models behave differently. If you decide to try this thing out, please let me know how the skills works for you. 🙏

The new migration skills are available in version 1.48 of the polylith-cli.