forcedotcom/sf-skills / plugins/builder/salesforce-code-quality/skills/dx-code-analyzer-custom-rule-create
dx-code-analyzer-custom-rule-create
VerifiedCreate custom Code Analyzer rules for Regex (pattern matching), PMD (XPath/AST for Apex and metadata XML), and ESLint (LWC/JavaScript/TypeScript). Use when users want to enforce coding standards, ban patterns, detect hardcoded values, govern metadata, or add rules not in the built-in set. TRIGGER when: user says 'create a rule', 'ban System.debug', 'enforce naming convention', 'detect hardcoded IDs', 'custom rule', 'xpath rule', 'regex rule', 'add a PMD rule', 'enforce a policy', 'create a check for', 'flag this pattern', 'make a rule that catches', 'metadata rule', 'check permissions', 'enforce API version', 'eslint rule', 'lwc rule', 'override rule threshold', 'customize complexity', or describes a pattern to enforce. DO NOT TRIGGER when: user wants to run a scan (use dx-code-analyzer-run), configure engines (use dx-code-analyzer-configure), or explain existing rules (use dx-code-analyzer-run).
examples/metadata-xml-example-fields-api.md
View on GitHub# Metadata XML Examples: Fields and API Version
[← Back to Metadata XML Examples Index](metadata-xml-examples.md)
## Example 2: Require Description on Custom Fields
**Problem:** Custom fields without descriptions make orgs hard to maintain.
**Target file:** `*.field-meta.xml`
**Sample violating metadata:**
```xml
<CustomField xmlns="http://soap.sforce.com/2006/04/metadata">
<fullName>Revenue__c</fullName>
<label>Revenue</label>
<type>Currency</type>
<!-- No <description> element! -->
</CustomField>
```
**XPath (PMD 7):**
```xpath
//*[local-name()='CustomField'][not(*[local-name()='description']) or *[local-name()='description'][not(@Text)]]
```
**How it works:** Matches `CustomField` elements that either lack a `<description>` child entirely, or have one with no text content (`@Text` absent means empty).
**PMD ruleset:**
```xml
<rule name="FieldRequiresDescription"
language="xml"
message="Custom field must have a non-empty description"
class="net.sourceforge.pmd.lang.rule.xpath.XPathRule">
<description>Enforces that all custom fields have a description for documentation</description>
<priority>3</priority>
<properties>
<property name="xpath">
<value><![CDATA[
//*[local-name()='CustomField'][not(*[local-name()='description']) or *[local-name()='description'][not(@Text)]]
]]></value>
</property>
</properties>
</rule>
```
---
## Example 3: Enforce Minimum API Version
**Problem:** Metadata using API versions older than 60.0 should be updated.
**Target file:** Any `*-meta.xml` with `<apiVersion>`
**Sample violating metadata:**
```xml
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>52.0</apiVersion>
<status>Active</status>
</ApexClass>
```
**XPath (PMD 7):**
```xpath
//*[local-name()='apiVersion']/*[number(@Text) < 60]
```
**How it works:** Finds `<apiVersion>` elements, then navigates to their child text node with `/*`. The `@Text` attribute on the text node holds the value (e.g., "52.0"). `number(@Text)` converts it to a float, and flags if < 60.
⚠️ **Key insight:** `@Text` lives on CHILD text nodes, not on elements. You must use `/*` to reach the text node — putting `[@Text]` directly on the element (after `local-name()='apiVersion'`) returns 0 matches.
**PMD ruleset:**
```xml
<rule name="MinimumApiVersion"
language="xml"
message="API version must be 60.0 or higher — update this metadata"
class="net.sourceforge.pmd.lang.rule.xpath.XPathRule">
<description>Enforces minimum API version of 60.0 across all metadata</description>
<priority>3</priority>
<properties>
<property name="xpath">
<value><![CDATA[
//*[local-name()='apiVersion']/*[number(@Text) < 60]
]]></value>
</property>
</properties>
</rule>
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |