michtio/craftcms-claude-skills

craft-plugins

Index and router for plugin-specific Craft CMS 5 guidance — configuration, Twig API, PHP API, migrations, deployment, and pitfalls for the plugins this pack documents.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/michtio/craftcms-claude-skills --skill craft-plugins

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Craft CMS 5 — Plugin References (Index & Router)

This skill is a router, not a tutorial. Its job is to make per-plugin guidance discoverable from any task framing — front-end, back-end PHP, content migration, deployment, or config — and point you at the right reference file.

Each plugin's curated reference lives in references/<plugin>.md and covers configuration, the Twig and/or PHP API, and the real-world pitfalls. Read the matching reference before implementing anything plugin-specific.

How to use this skill

  1. Identify the plugin(s) named in the task (by name, package, or feature).
  2. Open the matching references/<plugin>.md from the table below.
  3. If the task is back-end (PHP, content migration, events, deployment), check

the reference's back-end / programmatic sections specifically — several plugins (Formie, Feed Me, Element API, Amazon SES) are primarily or substantially back-end despite historically living under the front-end skill.

Routing table

ReferencePlugin (vendor)Primary altitudeKey surface
references/formie.mdFormie (verbb)Front-end and back-endForm rendering (one-line/granular), theme config; programmatic form creation in a content migration, editing an existing form's field in a migration, forms as DB elements (not project config), cross-environment deployment, multi-site/static translation, overriding Formie's bundled strings (server + client window.FormieTranslations), native min/max length validation & its two message keys, required+min interaction, File Upload volume + file renaming, notification attachments, captcha & caching
references/seomatic.mdSEOmatic (nystudio107)Front-end + configMeta cascade, Twig get/set API, JSON-LD, custom element SEO bundles, sitemaps, GraphQL
references/blitz.mdBlitz (putyourlightson)Mixed (front-end + ops)Refresh modes, Twig dynamic content, driver architecture (storage/purger/deployer), Nginx rewrite, Cloudflare integration
references/feed-me.mdFeed Me (craftcms)Back-end / opsData import from XML/JSON/CSV, field mapping, duplicate handling, CLI automation, scheduled imports
references/imager-x.mdImager X (spacecatninja)Front-end + configQuick syntax, responsive srcset, named transforms, Power Pack markup (ppimg/pppicture), automatic generation, transformers, effects, optimizers
references/image-optimize.mdImageOptimize (nystudio107)Front-end + field configOptimizedImages field, imgTag()/pictureTag() builders, loading strategies, transform methods, console commands
references/ckeditor.mdCKEditor (craftcms)Mixed (field config + front-end)Field settings (toolbar, headings, image mode), nested entries with chunk rendering and value helpers, link configuration, GraphQL Mode, ES-module custom plugins, HTML Purifier, Redactor migration
references/sprig.mdSprig (putyourlightson)Front-endReactive Twig components (htmx), live search, load more, pagination, filtering, form submissions without JS
references/element-api.mdElement API (craftcms)Back-end / configJSON API via config file, Fractal transformers, endpoint routing, pagination, caching
references/retour.mdRetour (nystudio107)Ops / configRedirect types (exact/regex), 404 tracking, CSV import, auto slug-change redirects, config
references/navigation.mdNavigation (verbb)Front-endNode querying, custom rendering, active states, custom fields on nodes, GraphQL
references/hyper.mdHyper (verbb)Front-end + field configLink types, getLinkAttributes(), getText(), single/multi-link, element access, button atom integration
references/colour-swatches.mdColour Swatches (craftpulse)MixedPalette config, multi-colour swatches, Tailwind class mapping, Twig model API
references/password-policy.mdPassword Policy (craftpulse)Back-end / configValidation rules, HIBP check, retention/expiry, console commands, recommended settings
references/typogrify.mdTypogrify (nystudio107)Front-end`\typogrify, \widont, \truncateOnWord`, smart quotes, widow prevention
references/cache-igniter.mdCache Igniter (putyourlightson)OpsGlobalPing warmer, geographic locations, refresh delay, Blitz companion
references/knock-knock.mdKnock Knock (verbb)Ops / configStaging password protection, environment-aware config, URL exclusions
references/timeloop.mdTimeloop (craftpulse)MixedRepeating date field, craft.timeloop variable API, recurringDates() function, GraphQL, period frequencies
references/elements-panel.mdElements Panel (putyourlightson)Dev toolingDebug toolbar panels for element population counts, duplicate detection, eager-loading opportunities
references/sherlock.mdSherlock (putyourlightson)Ops / configSecurity scanning, HTTP headers, CMS config checks, scheduled scans, IP restriction, monitoring
references/embedded-assets.mdEmbedded Assets (spicyweb)MixedoEmbed as first-class assets, craft.embeddedAssets.get(), iframe customization, GraphQL
references/amazon-ses.mdAmazon SES (putyourlightson)Back-end / configSES mail transport adapter, AWS credential config, SNS bounce tracking (no Twig API)
references/warp.mdWarp (craftpulse)Front-end and back-endPasswordless member auth: magic links (`mlToken`, never token), emailed one-time codes + segmented input, passkeys/WebAuthn, passwordless registration, session/device management. craft.warp variable, four fluent render builders (class accumulation + resetClass, key-by-key data merge, renderCss), @layer warp CSS escape, ten action routes (returnUrl vs Craft's redirect asymmetry, enumeration-safe responses, recent-auth-gated passkey routes), DOM contracts for hand-written markup
references/vite.mdVite (nystudio107)Front-end + buildchaincraft.vite.* Twig API (script, register, entry, asset, integrity, inline, includeCriticalCssTags, devServerRunning), vite.php config keys. Buildchain/vite.config.ts detail in the craft-site skill's references/vite-buildchain.md

Companion skills

  • `craftcms` — for the Craft core APIs a plugin task builds on: element saving, events, migrations, queue jobs, field-value storage. Load alongside this skill for any plugin PHP/migration work.
  • `craft-site` — for front-end template architecture the plugin output slots into (components, layouts, image presets). Load alongside this skill for plugin rendering/styling work.
  • `craft-content-modeling` — when the plugin interacts with sections, fields, volumes, or multi-site propagation.
  • `craft-cloud` / `servd` — when the plugin task involves deployment, edge caching, or ephemeral-filesystem constraints.

Related by task

from this repository

More skills

All skills
michtio
Community

craft-garnish

Garnish — Craft CMS's built-in JavaScript UI toolkit for the control panel. ALWAYS load when writing, editing, or reviewing JavaScript that runs in the Craft CP — plugin CP assets, custom field type JS, element index JS, CP webpack config, or code importing garnishjs / referencing window.Garnish. Also for CP accessibility, keyboard interactions, drag-sort, and CP JS memory issues. Triggers on: Garnish.Base.extend, this.base(), init, setSettings, addListener, on/off/trigger, destroy, garnishjs, G

installs
1
GitHub stars
82
Updated
Sep 14
michtio
Community

craft-php-guidelines

Craft CMS 5 PHP coding standards and conventions. ALWAYS load when writing, editing, reviewing, or discussing any PHP in a Craft plugin or module — even small edits. Also when running ECS, PHPStan, or scaffolding with ddev craft make. Covers: PHPDoc blocks (@author, @since, @throws chains), section headers (=========), class organization, naming conventions (services, queue jobs, records, events, enums), defineRules() and validation, beforePrepare() and addSelect(), MemoizableArray, DateTimeHelp

installs
1
GitHub stars
82
Updated
Sep 14
michtio
Community

craft-plugin-release

Releasing Craft CMS plugins — tagging, Packagist propagation, GitHub releases, branch promotion, shared-library ordering, history rewrites. ALWAYS load when cutting, preparing, verifying, or debugging a plugin release: bumping a version, dating a changelog, creating or moving a git tag, or checking what Packagist serves. Covers the composer.json version key (bump-or-omit trade-off, same-commit rule, verifying the tag's own blob), Packagist verification via repo.packagist.org/p2, the 'Skipped tag

installs
1
GitHub stars
82
Updated
Sep 14
michtio
Community

craft-site

Craft CMS 5 front-end Twig development — atomic design, template architecture, components, Vite buildchain. Covers atoms/molecules/organisms, props/extends/block patterns, layout chains, view routing, content builders, image presets, Tailwind named-key collections, multi-brand CSS tokens, JavaScript boundaries (Alpine/DataStar/Vue, tabs, accordions), Vite asset loading, and front-end auth (login, registration, password reset, profiles). Triggers on: {% include ... only %}, {% embed %}, atoms/mol

installs
1
GitHub stars
82
Updated
Sep 14