Initial commit

skills/wordpress-ability-api/scripts/README.md

@@ -0,0 +1,60 @@
+# WordPress Ability API Scripts
+
+This directory contains automation scripts for scaffolding and validating WordPress Abilities and Categories.
+
+## Scripts
+
+### Ability Scripts
+
+- **scaffold-ability.php** - Generate ability code from CLI arguments
+- **validate-ability.php** - Validate PHP ability registration code
+
+### Category Scripts
+
+- **scaffold-category.php** - Generate category registration code (PHP or JS)
+- **validate-category.php** - Validate PHP category registration code
+- **validate-category.js** - Validate JavaScript category registration code
+
+## Requirements
+
+### PHP Scripts
+
+- PHP 7.0+ (uses `token_get_all()` for parsing)
+- No external dependencies
+
+### JavaScript Validator
+
+- Node.js
+- acorn parser
+
+To install acorn:
+
+```bash
+npm install acorn
+```
+
+Or install globally:
+
+```bash
+npm install -g acorn
+```
+
+## Usage
+
+See individual script headers for detailed usage instructions.
+
+Quick examples:
+
+```bash
+# Scaffold a server-side ability
+php scaffold-ability.php --name="plugin/ability" --type="server" --category="data-retrieval"
+
+# Scaffold a category
+php scaffold-category.php --name="custom-category" --label="Custom" --description="Description" --type="server"
+
+# Validate PHP category
+php validate-category.php path/to/category.php
+
+# Validate JavaScript category
+node validate-category.js path/to/category.js
+```