al-folio Bootstrap
Use this skill when a user asks an agent to create, configure, or personalize a new al-folio v1.x website.
Workflow
- Read
AGENTS.md and docs/BOUNDARIES.md before editing.
- Keep the starter small: customize
_config.yml, _data, content collections, and site assets first.
- Leave runtime behavior in plugin repos. Do not copy plugin-owned layouts, includes, Sass, JavaScript, or assets into the starter unless the user intentionally wants a local override.
- For local visual/content customization, prefer:
_config.yml feature flags and site metadata_data/*.yml_pages, _posts, _projects, _news, _teachings, _bibliography- local
_includes, _layouts, and _sass overrides only when config/content cannot express the change
- Run validation before handing work back:
npm ci
npm run lint:prettier
bundle exec al-folio upgrade audit --no-fail
bundle exec jekyll build --baseurl /al-folio
Routing
- Starter wiring/docs/examples/tests: edit
al-folio.
- Shared layouts/includes/assets: use
al_folio_core.
- CV rendering: use
al_folio_cv.
- Distill runtime: use
al_folio_distill.
- Search/icons/math/comments/analytics/citations/external posts/newsletter/charts/images: use the owning
al-* plugin repo.
Handoff
Summarize changed files, validation results, and any local overrides created.
1---2name: al-folio-bootstrap3description: al-folio Bootstrap4---5# al-folio Bootstrap67Use this skill when a user asks an agent to create, configure, or personalize a new al-folio v1.x website.89## Workflow10111. Read `AGENTS.md` and `docs/BOUNDARIES.md` before editing.122. Keep the starter small: customize `_config.yml`, `_data`, content collections, and site assets first.133. Leave runtime behavior in plugin repos. Do not copy plugin-owned layouts, includes, Sass, JavaScript, or assets into the starter unless the user intentionally wants a local override.144. For local visual/content customization, prefer:15 - `_config.yml` feature flags and site metadata16 - `_data/*.yml`17 - `_pages`, `_posts`, `_projects`, `_news`, `_teachings`, `_bibliography`18 - local `_includes`, `_layouts`, and `_sass` overrides only when config/content cannot express the change195. Run validation before handing work back:2021```bash22npm ci23npm run lint:prettier24bundle exec al-folio upgrade audit --no-fail25bundle exec jekyll build --baseurl /al-folio26```2728## Routing2930- Starter wiring/docs/examples/tests: edit `al-folio`.31- Shared layouts/includes/assets: use `al_folio_core`.32- CV rendering: use `al_folio_cv`.33- Distill runtime: use `al_folio_distill`.34- Search/icons/math/comments/analytics/citations/external posts/newsletter/charts/images: use the owning `al-*` plugin repo.3536## Handoff3738Summarize changed files, validation results, and any local overrides created.
alshedivat