drupal-qa

Fix Drupal code quality issues across PHPCS, PHPMD, PHPStan, and CSpell.

3|5|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/sparkfabrik/sf-awesome-copilot --skill drupal-qa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drupal-qa
Source: https://github.com/sparkfabrik/sf-awesome-copilot/tree/main/skills/drupal/drupal-qa
Command: npx skills add https://github.com/sparkfabrik/sf-awesome-copilot --skill drupal-qa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drupal QA issues across PHPCS, PHPMD, PHPStan, and CSpell can block releases. This skill provides a structured approach to identify, fix, and align code with SparkFabrik standards without resorting to suppressions or ignores.

Core Features & Use Cases

  • Enforces and fixes Drupal code quality issues across PHPCS, PHPMD, PHPStan, and CSpell.
  • Guides developers to resolve issues in modules and custom codebases, with CI/pre-commit workflow integration.
  • Use Case: When a pre-commit hook or CI run reports QA errors, this Skill provides steps and examples to repair them per SparkFabrik standards.

Quick Start

Run make drupal-qa to start the QA workflow and begin addressing issues.

Frequently Asked Questions about drupal-qa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Drupal code quality issues from PHPCS and PHPStan without suppressions?

To fix Drupal code quality issues without suppressions, run a structured QA workflow that identifies and repairs PHPCS, PHPMD, PHPStan, and CSpell violations according to SparkFabrik standards.

Why do my pre-commit hooks fail on Drupal modules and how do I resolve the errors?

Pre-commit hooks fail on Drupal modules due to code quality violations detected by PHPCS or PHPStan. You resolve these errors by applying targeted fixes to your custom codebase instead of ignoring the warnings.

What is the best way to align a Drupal custom codebase with CI pipeline QA standards?

The best way to align a Drupal custom codebase with CI pipeline QA standards is to apply fixes across PHPCS, PHPMD, PHPStan, and CSpell configurations, ensuring all code meets guidelines before integration.

Does the Drupal QA workflow require specific PHP tooling and rulesets to function?

Yes, the Drupal QA workflow requires PHP tooling and SparkFabrik guidelines, including PHPCS rulesets, PHPMD configurations, PHPStan baselines, and a CSpell dictionary to function properly.

How do I resolve CSpell dictionary errors in my Drupal module code?

You resolve CSpell dictionary errors in Drupal module code by following a QA workflow that identifies spelling issues and aligns them with the required project-specific CSpell dictionary.

When should I avoid using inline suppressions for PHPMD and PHPCS warnings?

You should avoid using inline suppressions for PHPMD and PHPCS warnings whenever you can structurally repair the code, ensuring Drupal modules meet strict quality guidelines without hidden technical debt.