SQLx Migration

SkillDatabases & data

Lets your agent create SQLx database migration files using the sqlx migrate add command.

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the SQLx Migration skill

About this capability

Create SQLx migration files with `sqlx migrate add <name>`. Use when asked to add, create, or generate a sqlx/sqlx-cli database migration.

What this skill tells your AI

The instructions your AI receives, as published by macro-inc/macro in .pi/skills/sqlx-migration/SKILL.md and read by ahel’s review.

Use the SQLx CLI to create migration files instead of manually creating timestamped files.

Identify the project or crate root where SQLx migrations should live.
- Prefer the directory that contains an existing migrations/ directory.
- If there are multiple crates/projects, ask the user which one unless the target is obvious.
Convert the requested migration description to a short snake_case name, for example create_users_table.
Run just setup_test_envs from the project root
Run the SQLx CLI from crates/macro_db_client folder:
```
cargo sqlx migrate add name_of_migration
```
Replace name_of_migration with the actual snake_case migration name.
Do not manually add timestamps or hand-create migration filenames; sqlx migrate add generates the correct timestamped file.
After the command succeeds, read the generated migration file and add the requested SQL changes there.
If sqlx is not installed or not on PATH, stop and tell the user to install sqlx-cli rather than manually creating the migration file.

Advanced