| name | al-folio |
| description | Use this skill when a user asks an agent to migrate an existing customized al-folio fork to v1.x. |
| metadata | {"author":"alshedivat"} |
al-folio v1 Migration
Use this skill when a user asks an agent to migrate an existing customized al-folio fork to v1.x.
Workflow
- Work in a disposable branch, fork, or clone. Do not overwrite the user's original site.
- Start from the v1 starter contract, then bring over site-owned files:
_config.yml values_data_bibliography- content collections
- site assets
- intentional local
_includes, _layouts, and _sass overrides
- Keep v1 plugin wiring from the starter:
theme: al_folio_core- bundled
al_* and al_folio_* gems in Gemfile
- bundled plugin entries in
_config.yml
- Remove stale copied runtime files now owned by plugins unless they are intentional overrides.
- Run upgrade checks:
bundle exec al-folio upgrade audit --no-fail
bundle exec al-folio upgrade overrides audit
- For each stale or unacknowledged override:
bundle exec al-folio upgrade overrides diff LOCAL_PATH
bundle exec al-folio upgrade overrides accept LOCAL_PATH
- Build and inspect key pages: home, CV, publications, repositories, projects, posts, and any custom routes.
Migration Notes
Commit .al-folio-overrides.yml when the site intentionally keeps local overrides. It records the upstream plugin file checksum last reviewed so future gem updates can flag drift explicitly.
Handoff
Report removed stale runtime files, retained local overrides, unresolved visual differences, and exact validation commands.
Source: alshedivat/al-folio — distributed by TomeVault.
