skilld
All skills
michtio avatar

/craft-plugins

@44a2800
by Michael Thomasmichtio/craftcms-claude-skills82 stars
9

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. Triggers whenever a task names one of these plugins in ANY context (build, configure, style, render, query, import, migrate, deploy, cache, debug): Formie (forms, submissions, File Upload, form in a migration, notifications, translations), SEOmatic (meta, sitemaps, JSON-LD, SEO field), Blitz (static/page caching, purge), Feed Me (XML/JSON/CSV import), Imager-X (transforms, srcset, quick syntax, named transforms, Power Pack, pppicture, ppimg), ImageOptimize (OptimizedImages), CKEditor (rich text, nested entries), Sprig (reactive, htmx), Element API (JSON endpoints), Retour (redirects, 404s), Navigation (nav menus), Hyper (link field), Colour Swatches, Password Policy (HIBP), Typogrify, Cache Igniter, Knock Knock (staging password), Elements Panel (N+1 debug), Sherlock (security scan), Amazon SES (SES/SNS bounce), Embedded Assets (oEmbed), Timeloop (recurring dates), Vite (craft.vite.*, asset bundling), Warp (passwordless login, magic link, one-time code/OTP, passkeys, WebAuthn, craft.warp, member sessions). Also load for passwordless or magic-link auth with NO plugin named. Always load when a task names one of these plugins — read references/<plugin>.md first. Do NOT trigger for Craft core with no plugin named (craftcms), template architecture (craft-site), or content modeling (craft-content-modeling).

Ask your Agent

Use this Skill: https://skilld.dev/gh/michtio/craftcms-claude-skills/craft-plugins

This session only. Nothing lands on disk.

referenceselements-panel.md

≈625 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Elements Panel

Debug toolbar plugin by PutYourLightsOn. Adds an Elements panel and an Eager-Loading panel to Craft's debug toolbar for benchmarking template performance. Shows element population counts, duplicates, and missed eager-loading opportunities. Essential development-time tool — used in 5/6 projects.

putyourlightson/craft-elements-panel — Free (MIT)

Documentation

Setup

Install, then enable the debug toolbar:

  1. CP → My Account → Preferences → check "Show the debug toolbar on the front end"
  2. Visit the front-end — the Elements and Eager-Loading panels appear in the debug toolbar

No config file. No settings. Just install and use.

Elements Panel

Shows how many elements were populated during the request, grouped by element type. Flags duplicates — the same element populated more than once.

A duplicate means an element was fetched multiple times during a single request. Fix with eager-loading (.with() / .eagerly()) or memoizing the query result to a variable.

Some duplicates are acceptable (globals, navigation nodes accessed from multiple templates). The warning is when duplicates "explode" — e.g., 200 duplicate entries from an N+1 inside a loop.

Eager-Loading Panel

Shows element queries that could have been eager-loaded. Grouped by field name. Flags duplicate queries — the same relation field queried multiple times when it could have been eager-loaded.

Use this to identify:

  • Relation fields inside loops missing .eagerly()
  • Matrix blocks whose nested relations aren't eager-loaded
  • Asset transforms not being preloaded

Common Pitfalls

  • Not enabling the debug toolbar — the panels don't appear unless it's active. This is a per-user setting, not global.
  • Ignoring it in development — this is the fastest way to catch N+1 problems before they hit production. Check it on every template.
  • Treating all duplicates as problems — some duplication is normal (globals, user elements). Focus on high-count duplicates.
  • Only checking on simple pages — test on index pages with many entries and deep relation chains. That's where N+1 problems surface.

Pair With

  • Blitz — fix N+1 issues found by Elements Panel, then cache the optimized pages with Blitz
  • Web Vitals skill — Elements Panel surfaces the template-level performance issues that affect TTFB

Source: SKILL.md on GitHub

Third-party checks

No alerts16d3 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The 'craft-plugins' skill is a technical reference and router for Craft CMS 5 plugins. It provides guidance on configuration, Twig and PHP APIs, and best practices for popular extensions in the Craft ecosystem. The skill consists of documentation files that describe legitimate plugin behaviors and does not contain any malicious code, obfuscation, or security vulnerabilities.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

Provenance

Signed by skilld at 44a2800. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 weeks ago.

Activeupdated last month

README badge

README badge for michtio/craftcms-claude-skills/craft-plugins