Use this skill when a user asks an agent to create, configure, or personalize a new al-folio v1.x website.
- Read
AGENTS.mdanddocs/BOUNDARIES.mdbefore 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.ymlfeature flags and site metadata_data/*.yml_pages,_posts,_projects,_news,_teachings,_bibliography- local
_includes,_layouts, and_sassoverrides 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- 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.
Summarize changed files, validation results, and any local overrides created.