al-folio is a Jekyll starter for building academic websites, personal sites, and portfolios. It is used by academics who want a responsive site based on independently versioned plugin components.
Borrowing it
Nothing to install: this file belongs to alshedivat/al-folio. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/alshedivat/al-folio/main/.agents/skills/al-folio-v1-migration/SKILL.mdgit clone --depth 1 https://github.com/alshedivat/al-folioWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/alshedivat/al-folio/al-folio-v1-migration)<a href="https://agentmods.dev/skills/alshedivat/al-folio/al-folio-v1-migration"><img src="https://agentmods.dev/badge/skills/alshedivat/al-folio/al-folio-v1-migration/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/alshedivat/al-folio/al-folio-v1-migration"><img src="https://agentmods.dev/badge/skills/alshedivat/al-folio/al-folio-v1-migration.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00000 | $0.00343 |
| Opus 5 | $0.00000 | $0.00171 |
| Sonnet 5 | $0.00000 | $0.00069 |
| Haiku 4.5 | $0.00000 | $0.00034 |
Grade A, and why
al-folio-v1-migration scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
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.ymlvalues_data_bibliography- content collections
- site assets
- intentional local
_includes,_layouts, and_sassoverrides
- Keep v1 plugin wiring from the starter:
theme: al_folio_core- bundled
al_*andal_folio_*gems inGemfile - 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.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 12d ago First seen · 43 lines · 0 tokens per session scan A 63483ff4ffde
al-folio-v1-migration is a skill published in the GitHub repository alshedivat/al-folio (16,117 stars, last pushed 4d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 343 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
muxy-extension
Best-practice guide for authoring a Muxy extension — how it should look and behave so it reads as a native part of the app. Covers theming (follow the theme, never hardcode colors), the sizing scale, and which surface to use. Mechanics (manifest fields, permissions, the window.muxy API) live in the linked docs.
guestbook
Read and sign the guestbook at rimzzlabs.com. Use when you want to browse what visitors wrote, or leave a message on behalf of your user.
plotly
Interactive visualization library. Use when you need hover info, zoom, pan, or web-embeddable charts. Best for dashboards, exploratory analysis, and presentations. For static publication figures use matplotlib or scientific-visualization.
paper-webpage-builder
Build a polished single-page academic project webpage from a paper directory or paper source, including content extraction, figure selection/conversion, module planning, visual design, tables, assets, and validation. Use when asked to create or update webpages for papers, benchmarks, arXiv-style projects, OpenRaiser…
add-app-tool
Scaffold an MCP App tool + UI resource pair. Use when the user asks to add a tool with interactive UI, create an MCP App, or build a visual/interactive tool.
visual-ralph
Visual Ralph orchestration for frontend UI from generated references, static references, or live URL targets, using $ralph with built-in visual verdict and pixel-diff evidence until the implementation matches and leaves a reproducible design system.