Use this skill whenever you need to add a new language/locale to a Bolt CMS site, configure multilingual routing, or maintain full parity across all translations, ContentTypes, navigation menus, and theme language switchers.
Skills
vondry/bolt-skills
AI agent skills, workflows and verification scripts for building, securing and maintaining Bolt CMS websites. Works with Claude Code, Cursor, Gemini and other agents.
npx skilld add vondry/bolt-skills --allUse this skill whenever setting up, optimizing, or debugging client/CDN HTTP caching for Bolt CMS images, thumbnails, CSS, JS, and PDFs. Resolves the critical Symfony SessionListener bug where stateful firewalls rewrite League Glide's public 1-year thumbnail cache to private/no-cache, configures Bolt's save_files thumbnail disk dump, sets up Apache mod_expires and Nginx static expires rules, establishes frontend asset cache-busting (?v=X.X), and checks end to end — Apache with the project's .htaccess plus PHP-FPM, or production — that every thumbnail and upload is served from disk with ETag, Last-Modified, max-age and 304s instead of by PHP.
Read-only audit of an existing Bolt CMS 6 project against every bolt-skills skill. Profiles the project, runs all 20 verification scripts in workflow order, compares the project's files with the skills' examples, then reviews each skill one by one (logs, SKILL.md rules, references) and writes a prioritized AUDIT.md report — defects vs. convention deviations, severity, evidence and the skill step that fixes each finding. Use when asked to audit, review, check or assess an existing Bolt site, or before taking over or upgrading one.
Build a complete Bolt CMS 6 website from a supplied design — Figma (Figma MCP), Pencil / pen.dev (.pen via Pencil MCP), exported images or PDF, an existing website, or a brief — by running the whole WORKFLOWS.md (Phases 0–8, all 20 skills) autonomously. Reads the design first, asks every question the workflow needs in one upfront intake, writes the site plan, then builds, verifies, commits gate by gate and keeps a resumable progress log. Use when asked to create, build or implement a website (or "make this design into a Bolt site").
Use this skill whenever setting up, standardizing, or verifying PHP code quality, static analysis, and CI/CD pipelines in a Bolt CMS repository. Configures Easy Coding Standard (ECS) with PSR-12/cleanCode rules, PHPStan level max static analysis on src/, unified Makefile commands (cscheck, csfix, stancheck, csclear), safe Doctrine migration synchronization, and a GitLab CI matrix for PHP 8.4–8.5.
Use this skill whenever you need to create, modify, or validate ContentTypes and fields in Bolt CMS (config/bolt/contenttypes.yaml). Enforces strict best practices: no raw html fields (use redactor or article), sanitise: true on every rich-text field and never allow_twig, mandatory order: -id on singletons, no reserved field names (icon, status, author, … — and label, value, name, type inside sets), an explicit slug on every ContentType, all identifiers in English, admin icons only from the Font Awesome 5.15.4 solid set Bolt bundles (no FA 6 names like sliders or screwdriver-wrench), viewless resource blocks, collection/set structuring, multilingual consistency, and a clean Bolt Configuration Notices check before content.
Intake-driven cookie banner and privacy policy page for Czech Bolt CMS sites (ZEK § 89/3, GDPR, ÚOOÚ / EDPB practice). Asks which trackers (Google Analytics 4, Google Ads, Seznam Sklik, Meta Pixel, …), embeds and controller model the site uses, writes one data model into theme.yaml (or validates one kept in a privacy ContentType), and renders from it a two-layer opt-in banner (Consent Mode v2, equal Accept / Reject, per-category settings), consent-gated embeds and the /zasady-ochrany-osobnich-udaju page — styled with the theme's design tokens and verified by scripts/verify.sh.
Use this skill when the user wants to disable, turn off, or lock down Bolt CMS API endpoints, GraphQL, OpenAPI documentation (Swagger UI, ReDoc, Scalar), GraphiQL, or prevent data exposure via the API in development and/or production environments.
Use this skill whenever installing, configuring, or verifying the essential Bolt CMS extensions: AppoloDev/bolt-seo (SEO meta fields and tags, with the canonical URL override needed until bolt/core PR #3735 is released), Vondry/bolt-sitemap (tomvondracek/bolt-sitemap: spec-compliant XML sitemap index with static pages, no theme override), Vondry/bolt-llms-txt (llmstxt.org dynamic endpoint), and tomvondracek/bolt-request-analytics (cookieless server-side visitor statistics in the backend, with domain alias counting).
Use this skill whenever creating, styling, or validating helper and error pages in Bolt CMS: 404 (Not Found), 403 (Forbidden), 500 (Internal Server Error), and 503 (Maintenance Mode). Enforces configuration mappings in config/bolt/config.yaml, dual-base layout strategy, the zero-database rule for the 500 and 503 pages (a 503 without contact details, numbers or time promises), noindex SEO directives, and bespoke brand-aligned visual scenes.
Use this skill whenever creating, configuring, or hardening Apache .htaccess files in a Bolt CMS repository. Implements the production two-tier .htaccess architecture: root-level HTTPS redirection and ./public directory forwarding for web hosts, plus public/.htaccess protection — an allowlist for theme/, files/ and thumbs/ (only built assets and accepted upload types are served, everything else is 403), a safety-net deny list for sources, configs, dumps and .env files elsewhere in public/, and security headers for static files (HSTS, nosniff, sandboxed uploads).
Use this skill whenever configuring, structuring, or verifying Bolt CMS navigation menus in config/bolt/menu.yaml (header 'main', footer columns, submenus, multilingual labels, /#anchor formatting, and CTA classes) and rendering them through the Twig Component/Container templates (header with dropdowns and mobile drawer, footer columns, nav components, logo).
Use this skill whenever setting up, modifying, or verifying essential custom PHP Twig extensions under src/ in Bolt CMS. Deploys App\LocaleLinkExtension for automatic multi-language URL prefixing (locale_link), App\ImageDimensionsExtension for cached disk image resolution needed by PhotoSwipe (image_dimensions), and App\FileSizeExtension for human-readable download sizes (file_size, format_file_size), wired through #[Autowire] attributes with no service definitions in config/services.yaml.
Use this skill whenever setting up, extracting, or updating Tailwind CSS v4 design tokens, @theme configurations, font-face definitions, and repeating utility classes from handed-off designs (Figma, Penpot, or design specs) in Bolt CMS themes. Establishes WCAG AA contrast targets, fluid clamp() typography, Czech latin-ext font ranges, @source scanning safeguards, and the complete blueprint of cross-project repeating utility classes (wrapper, px-edge, py-section, btn variants, card, link-arrow, pagination, and .cms-redactor).
Use this skill whenever bootstrapping, scaffolding, or structuring a new Bolt CMS theme from scratch. Establishes the Component/Container/Page architecture (pure components with zero setcontent, smart containers with CMS queries, page orchestrators with minimal raw HTML, and page-scoped components) and the shared layout shell partials/_master.twig, configures Tailwind CSS v4 CLI, Rollup for TypeScript (menu accordions and mobile drawer, anchor scrolling, locale switcher, PhotoSwipe), links the theme in config/bolt/config.yaml, binds ContentTypes to their templates (example: products → product.twig / product.record.twig), and verifies the result automatically.
Use this skill whenever building, extending, or reviewing Bolt CMS Twig templates with Tailwind CSS v4 under the Component / Container / Page architecture: the pure UI component library (button, badge, card, picture with PhotoSwipe, breadcrumbs, pagination for pager(), empty state, section header), smart containers (contact section/banner, featured products), page orchestrators per ContentType with page-scoped components, the search results page every Bolt site serves at /search (in the theme's design, verified live: results with HTTP 200 and the locale kept), their translation catalogs, and automated verification (layout contract, purity, translation traps, undefined classes, lint, search).
Use this skill whenever setting, configuring, or verifying the timezone (specifically Europe/Prague) in a Bolt CMS repository. Aligns all execution layers—config/bolt/config.yaml, src/Kernel.php boot override, Docker php.ini configurations, and compose.yaml environment—to prevent the critical Bolt CMS date-shifting bug on record saves.
Curated skills from @vondry. Checked GitHub just now