joao-silva-ntt/drupal-agent-toolkit
Reusable Drupal agents, skills, rules, and optional QA helpers.
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.
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".
Manage Drupal block placement configuration, menu blocks, theme regions, visibility conditions, weights, and recipe integration.
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.
Manage Drupal Config Split across environments: split activation, partial/complete lists, directories, export/import, and troubleshooting.
Manage Drupal configuration synchronization, schema, environment overrides, deployment, and configuration troubleshooting.
Debug Drupal runtime, cache, configuration, database, render, Twig, and service issues with focused inspection and project-configured tools.
Create accurate Drupal editor manuals and training guides with accessible instructions, localized editions, screenshots, and exports.
Improve Drupal back-office UX for editors: forms, entity displays, field groups, widgets, help text, admin styling, validation, permissions, and accessible workflows.
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.
Create and configure Drupal Paragraph types, fields, references, forms, and displays. Consult project settings for the widget and rendering approach.
Configure and troubleshoot Drupal Pathauto patterns, URL aliases, and regeneration workflows.
Create, compose, apply, and troubleshoot Drupal recipes, including install lists, config imports/actions, inputs, and repeatable setup.
Configure Drupal image styles, responsive image mappings, media view displays, and Paragraph image rendering across declared breakpoints.
Create and maintain Drupal Single Directory Components with accessible metadata, props, slots, Twig output, and Styleguide examples.
Make Drupal SDC components safe across Styleguide, frontend rendering, and editorial previews; use for render arrays, prop mappings, slots, and asset-context defects.
Harden Drupal projects and review security configuration, authentication, sessions, uploads, permissions, headers, and abuse controls.
Improve Drupal sustainability through efficient code, maintainable architecture, performance, accessibility, reduced data transfer, and measured resource use.
Create, run, and debug Drupal unit, Kernel, Functional, JavaScript, and browser/accessibility tests using the repository's configured tooling.
Create and maintain Drupal themes using Twig, libraries, preprocess functions, Drupal behaviors, styles, responsive layouts, and accessible components.
Assess or execute Drupal major-version upgrades, compatibility remediation, Composer planning, database update risks, and post-upgrade verification.
Configure and extend Drupal Views: displays, exposed filters, plugins, handlers, Views data, entity queries, APIs, caching, and tests.
Create, configure, and maintain Drupal Webforms, elements, handlers, spam controls, upload behavior, access, and deployment.
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.
Check QA readiness, set up missing accessibility/performance tests with approval, and run profile-configured audits for an explicit Drupal target.