Skip to content

joao-silva-ntt/drupal-agent-toolkit

v0.3.0MIT

Reusable Drupal agents, skills, rules, and optional QA helpers.

accessibility

Expert web accessibility guidance grounded in WCAG 2.2, WAI-ARIA 1.2, and ARIA Authoring Practices. Use this skill whenever the user asks about accessibility, a11y, WCAG compliance, ARIA roles/attributes, keyboard navigation, screen reader support, color contrast, alt text, form labels, focus management, skip links, captions, semantic HTML, accessible components, or any disability-related web topic. Also use it when the user shares code and asks you to review, audit, or improve it — even if they don't explicitly mention accessibility. Use it for questions like "why isn't my screen reader reading this?", "make my modal keyboard-accessible", "do I need captions here?", "what level is 1.4.3?", or "help me pass a WCAG audit". In short: if web accessibility is anywhere in the picture, use this skill.

atomic-design

Methodology and best practices for organising UI components using the Atomic Design system (atoms, molecules, organisms, templates, pages). Use this skill when the request is about component hierarchy decisions, reuse-first decomposition, design-system structure, or choosing the right atomic level for a UI change. For Drupal, apply Atomic Design through the component system already used by the project. Trigger phrases: "atomic design", "atoms", "molecules", "organisms", "templates", "pages", "component hierarchy", "design system structure", "component library", "Brad Frost", "component composition", "ui architecture", "create component", "new component", "add component", "implement design", "figma", "frontend component", "sdc", "twig component", "paragraph type", "drupal frontend".

drupal-blocks

Manage Drupal block placement configuration, menu blocks, theme regions, visibility conditions, weights, and recipe integration.

drupal-caching

Use when implementing or debugging Drupal cache tags, cache contexts, max-age, render caching, Dynamic Page Cache, cache bins, lazy builders, invalidation, or cache-related performance issues.

drupal-config-split

Manage Drupal Config Split across environments: split activation, partial/complete lists, directories, export/import, and troubleshooting.

drupal-configuration-management

Manage Drupal configuration synchronization, schema, environment overrides, deployment, and configuration troubleshooting.

drupal-debugging

Debug Drupal runtime, cache, configuration, database, render, Twig, and service issues with focused inspection and project-configured tools.

drupal-editor-manuals

Create accurate Drupal editor manuals and training guides with accessible instructions, localized editions, screenshots, and exports.

drupal-editorial-ux

Improve Drupal back-office UX for editors: forms, entity displays, field groups, widgets, help text, admin styling, validation, permissions, and accessible workflows.

drupal-module-development

Create and maintain custom Drupal modules. Use for module metadata, controllers, forms, services, plugins, event subscribers, hooks, update hooks, dependency injection, Entity API, and tests.

drupal-paragraphs

Create and configure Drupal Paragraph types, fields, references, forms, and displays. Consult project settings for the widget and rendering approach.

drupal-pathauto

Configure and troubleshoot Drupal Pathauto patterns, URL aliases, and regeneration workflows.

drupal-recipes

Create, compose, apply, and troubleshoot Drupal recipes, including install lists, config imports/actions, inputs, and repeatable setup.

drupal-responsive-images

Configure Drupal image styles, responsive image mappings, media view displays, and Paragraph image rendering across declared breakpoints.

drupal-sdc-components

Create and maintain Drupal Single Directory Components with accessible metadata, props, slots, Twig output, and Styleguide examples.

drupal-sdc-styleguide-safe

Make Drupal SDC components safe across Styleguide, frontend rendering, and editorial previews; use for render arrays, prop mappings, slots, and asset-context defects.

drupal-security

Harden Drupal projects and review security configuration, authentication, sessions, uploads, permissions, headers, and abuse controls.

drupal-sustainability

Improve Drupal sustainability through efficient code, maintainable architecture, performance, accessibility, reduced data transfer, and measured resource use.

drupal-testing

Create, run, and debug Drupal unit, Kernel, Functional, JavaScript, and browser/accessibility tests using the repository's configured tooling.

drupal-theme-development

Create and maintain Drupal themes using Twig, libraries, preprocess functions, Drupal behaviors, styles, responsive layouts, and accessible components.

drupal-upgrade

Assess or execute Drupal major-version upgrades, compatibility remediation, Composer planning, database update risks, and post-upgrade verification.

drupal-views-development

Configure and extend Drupal Views: displays, exposed filters, plugins, handlers, Views data, entity queries, APIs, caching, and tests.

drupal-webforms

Create, configure, and maintain Drupal Webforms, elements, handlers, spam controls, upload behavior, access, and deployment.

figma-design

Access and work with Figma designs, components, and design systems. Use when user provides Figma URLs, asks about design specifications, needs to extract design tokens, compare implementation with mockups, or generate code from Figma components. Works with Figma MCP server to retrieve design data.

quality-audit

Check QA readiness, set up missing accessibility/performance tests with approval, and run profile-configured audits for an explicit Drupal target.