design-systems-slds-validate

Audit Lightning Web Components for SLDS compliance and generate a scored quality report.

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/padjei/SF_Build --skill design-systems-slds-validate-padjei
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-systems-slds-validate
Source: https://github.com/padjei/SF_Build/tree/main/.claude/skills/design-systems-slds-validate
Command: npx skills add https://github.com/padjei/SF_Build --skill design-systems-slds-validate-padjei

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @salesforce-ux/slds-linter, and includes scripts (resource) and references (resource) components.

What problem does it solve? Lightning Web Components often accumulate SLDS violations, accessibility gaps, and theming issues that the standard linter alone cannot catch, leaving teams without a clear measure of whether a component is ready to ship. ## Core Features & Use Cases - Automated Multi-Category Scoring: Combines SLDS linter output with a supplementary analysis script to score Linter Compliance, Theming, Accessibility, Code Quality, and Component Usage into an overall A-F grade. - Linter-Complementary Static Analysis: Detects missing hook fallbacks, invented SLDS hooks, hook pairing mismatches, missing labels and alt text, inline styles, and magic pixel values across CSS, HTML, and JS files. - Manual Review Gate: Applies a Pass/Advisory/Blocking gate for loading, error, empty, and disabled states plus blueprint compliance, so a high automated score cannot override blocking findings. - Use Case: Before submitting a new LWC for code review, run the audit to get a compact scorecard with an overall grade, top issues with file and line references, and a final production-readiness recommendation. ## Quick Start Audit my Lightning Web Component at force-app/main/default/lwc/myComponent for SLDS compliance and give me the quality scorecard.

Frequently Asked Questions about design-systems-slds-validate

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

FAQPage Schema
How do I audit a Lightning Web Component for SLDS compliance?▼

Run the SLDS linter with npx @salesforce-ux/slds-linter lint on the component path, then run the analyze-quality.cjs script for supplementary checks. Combine both outputs with a manual review of states and blueprint structure to compute the final grade and recommendation.

What does the SLDS quality scorecard measure?▼

The scorecard measures five weighted categories: Linter Compliance at 30%, Theming at 20%, Accessibility at 20%, Code Quality at 15%, and Component Usage at 15%. Each category starts at 100 and loses points per finding, producing an overall A through F grade.

Can this skill fix SLDS linter violations automatically?▼

No, this skill only audits and reports violations. Fixing linter violations is handled by the design-systems-slds2-migrate skill, and building new components is handled by design-systems-slds-apply.

Does the SLDS audit work without Node.js or network access?▼

Yes, partially. If the linter cannot run, the report notes it as not run, marks Linter Compliance as N/A, and renormalizes the overall score across the remaining four categories. The analysis script itself requires Node.js to execute.

Is this a full WCAG accessibility audit for LWC components?▼

No, the accessibility checks verify attribute presence only, such as labels, alt text, and focus indicators. They do not validate contrast ratios, keyboard flows, or screen reader behavior, so passing does not guarantee WCAG compliance.

Why did my component get a good grade but a not-ready recommendation?▼

The automated grade reflects only linter and script findings. The manual review gate can return Blocking for issues like missing error states or incorrect blueprint structure, which overrides the automated score and marks the component not ready for production.