opencode-skills-antigravity 1.0.11 → 1.0.13

package/bundled-skills/wordpress-plugin-development/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wordpress-plugin-development
-description: "WordPress plugin development workflow covering plugin architecture, hooks, admin interfaces, REST API, and security best practices."
+description: "WordPress plugin development workflow covering plugin architecture, hooks, admin interfaces, REST API, security best practices, and WordPress 7.0 features: Real-Time Collaboration, AI Connectors, Abilities API, DataViews, and PHP-only blocks."
 category: granular-workflow-bundle
 risk: safe
 source: personal
@@ -11,7 +11,35 @@ date_added: "2026-02-27"
 
 ## Overview
 
-Specialized workflow for creating WordPress plugins with proper architecture, hooks system, admin interfaces, REST API endpoints, and security practices.
+Specialized workflow for creating WordPress plugins with proper architecture, hooks system, admin interfaces, REST API endpoints, and security practices. Now includes WordPress 7.0 features for modern plugin development.
+
+## WordPress 7.0 Plugin Development
+
+### Key Features for Plugin Developers
+
+1. **Real-Time Collaboration (RTC) Compatibility**
+   - Yjs-based CRDT for simultaneous editing
+   - Custom transport via `sync.providers` filter
+   - **Requirement**: Register post meta with `show_in_rest => true`
+
+2. **AI Connector Integration**
+   - Provider-agnostic AI via `wp_ai_client_prompt()`
+   - Settings > Connectors admin screen
+   - Works with OpenAI, Claude, Gemini, Ollama
+
+3. **Abilities API**
+   - Declare plugin capabilities for AI agents
+   - REST API: `/wp-json/abilities/v1/manifest`
+   - MCP adapter support
+
+4. **DataViews & DataForm**
+   - Modern admin interfaces
+   - Replaces WP_List_Table patterns
+   - Built-in validation
+
+5. **PHP-Only Blocks**
+   - Register blocks without JavaScript
+   - Auto-generated Inspector controls
 
 ## When to Use This Workflow
 
@@ -21,6 +49,7 @@ Use this workflow when:
 - Building admin interfaces
 - Adding REST API endpoints
 - Integrating third-party services
+- Implementing WordPress 7.0 AI/Collaboration features
 
 ## Workflow Phases
 
@@ -37,6 +66,20 @@ Use this workflow when:
 4. Set up autoloading
 5. Configure text domain
 
+#### WordPress 7.0 Plugin Header
+```php
+/*
+Plugin Name: My Plugin
+Plugin URI: https://example.com/my-plugin
+Description: A WordPress 7.0 compatible plugin with AI and RTC support
+Version: 1.0.0
+Requires at least: 6.0
+Requires PHP: 7.4
+Author: Developer Name
+License: GPL2+
+*/
+```
+
 #### Copy-Paste Prompts
 ```
 Use @app-builder to scaffold a new WordPress plugin
@@ -54,6 +97,11 @@ Use @app-builder to scaffold a new WordPress plugin
 4. Set up dependency injection
 5. Configure plugin lifecycle
 
+#### WordPress 7.0 Architecture Considerations
+- Prepare for iframed editor compatibility
+- Design for collaboration-aware data flows
+- Consider Abilities API for AI integration
+
 #### Copy-Paste Prompts
 ```
 Use @backend-dev-guidelines to design plugin architecture
@@ -88,6 +136,39 @@ Use @wordpress-penetration-testing to understand WordPress hooks
 4. Add settings sections/fields
 5. Create admin notices
 
+#### WordPress 7.0 Admin Considerations
+- Test with new admin color scheme
+- Consider DataViews for data displays
+- Implement view transitions
+- Use new validation patterns
+
+#### DataViews Example
+```javascript
+import { DataViews } from '@wordpress/dataviews';
+
+const MyPluginDataView = () => {
+    const data = [/* records */];
+    const fields = [
+        { id: 'title', label: 'Title', sortable: true },
+        { id: 'status', label: 'Status', filterBy: true }
+    ];
+    const view = {
+        type: 'table',
+        perPage: 10,
+        sort: { field: 'title', direction: 'asc' }
+    };
+
+    return (
+        <DataViews
+            data={data}
+            fields={fields}
+            view={view}
+            onChangeView={handleViewChange}
+        />
+    );
+};
+```
+
 #### Copy-Paste Prompts
 ```
 Use @frontend-developer to create WordPress admin interface
@@ -106,6 +187,23 @@ Use @frontend-developer to create WordPress admin interface
 4. Set up data sanitization
 5. Create data upgrade routines
 
+#### RTC-Compatible Post Meta
+```php
+// Register meta for Real-Time Collaboration
+register_post_meta('post', 'my_custom_field', [
+    'type' => 'string',
+    'single' => true,
+    'show_in_rest' => true,  // Required for RTC
+    'sanitize_callback' => 'sanitize_text_field',
+]);
+
+// For WP 7.0, also consider:
+register_term_meta('category', 'my_term_field', [
+    'type' => 'string',
+    'show_in_rest' => true,
+]);
+```
+
 #### Copy-Paste Prompts
 ```
 Use @database-design to design plugin database schema
@@ -124,6 +222,11 @@ Use @database-design to design plugin database schema
 4. Add request validation
 5. Document API endpoints
 
+#### WordPress 7.0 REST API Enhancements
+- Abilities API integration
+- AI Connector endpoints
+- Enhanced validation
+
 #### Copy-Paste Prompts
 ```
 Use @api-design-principles to create WordPress REST API endpoints
@@ -142,12 +245,180 @@ Use @api-design-principles to create WordPress REST API endpoints
 4. Escape all outputs
 5. Secure database queries
 
+#### WordPress 7.0 Security Considerations
+- Test Abilities API permission boundaries
+- Validate AI connector credential handling
+- Review collaboration data isolation
+- PHP 7.4+ requirement compliance
+
 #### Copy-Paste Prompts
 ```
 Use @wordpress-penetration-testing to audit plugin security
 ```
 
-### Phase 8: Testing
+### Phase 8: WordPress 7.0 Features
+
+#### Skills to Invoke
+- `api-design-principles` - AI integration
+- `backend-dev-guidelines` - Block development
+
+#### AI Connector Implementation
+```php
+// Using WordPress 7.0 AI Connector
+add_action('save_post', 'my_plugin_generate_ai_summary', 10, 2);
+
+function my_plugin_generate_ai_summary($post_id, $post) {
+    if (wp_is_post_autosave($post_id) || wp_is_post_revision($post_id)) {
+        return;
+    }
+    
+    // Check if AI client is available
+    if (!function_exists('wp_ai_client_prompt')) {
+        return;
+    }
+    
+    $content = strip_tags($post->post_content);
+    if (empty($content)) {
+        return;
+    }
+    
+    // Build prompt - direct string concatenation for input
+    $result = wp_ai_client_prompt(
+        'Create a compelling 2-sentence summary for social media: ' . substr($content, 0, 1000)
+    );
+    
+    if (is_wp_error($result)) {
+        return;
+    }
+    
+    // Set temperature for consistent output
+    $result->using_temperature(0.3);
+    $summary = $result->generate_text();
+    
+    if ($summary && !is_wp_error($summary)) {
+        update_post_meta($post_id, '_ai_summary', sanitize_textarea_field($summary));
+    }
+}
+```
+
+#### Abilities API Registration
+```php
+// Register ability categories on their own hook
+add_action('wp_abilities_api_categories_init', function() {
+    wp_register_ability_category('content-creation', [
+        'label' => __('Content Creation', 'my-plugin'),
+        'description' => __('Abilities for generating and managing content', 'my-plugin'),
+    ]);
+});
+
+// Register abilities on their own hook
+add_action('wp_abilities_api_init', function() {
+    wp_register_ability('my-plugin/generate-summary', [
+        'label' => __('Generate Summary', 'my-plugin'),
+        'description' => __('Creates an AI-powered summary of content', 'my-plugin'),
+        'category' => 'content-creation',
+        'input_schema' => [
+            'type' => 'object',
+            'properties' => [
+                'content' => ['type' => 'string'],
+                'length' => ['type' => 'integer', 'default' => 2]
+            ],
+            'required' => ['content']
+        ],
+        'output_schema' => [
+            'type' => 'object',
+            'properties' => [
+                'summary' => ['type' => 'string']
+            ]
+        ],
+        'execute_callback' => 'my_plugin_generate_summary_cb',
+        'permission_callback' => function() {
+            return current_user_can('edit_posts');
+        }
+    ]);
+});
+
+// Handler callback
+function my_plugin_generate_summary_cb($input) {
+    $content = isset($input['content']) ? $input['content'] : '';
+    $length = isset($input['length']) ? absint($input['length']) : 2;
+    
+    if (empty($content)) {
+        return new WP_Error('empty_content', 'No content provided');
+    }
+    
+    if (!function_exists('wp_ai_client_prompt')) {
+        return new WP_Error('ai_unavailable', 'AI not available');
+    }
+    
+    $prompt = sprintf('Create a %d-sentence summary of: %s', $length, substr($content, 0, 2000));
+    
+    $result = wp_ai_client_prompt($prompt)
+        ->using_temperature(0.3)
+        ->generate_text();
+    
+    if (is_wp_error($result)) {
+        return $result;
+    }
+    
+    return ['summary' => sanitize_textarea_field($result)];
+}
+```
+
+#### PHP-Only Block Registration
+```php
+// Register block entirely in PHP (WordPress 7.0)
+// Note: For full PHP-only blocks, use block.json with PHP render_callback
+
+// First, create a block.json file in build/ or includes/blocks/
+// Then register in PHP:
+
+// Simple PHP-only block registration (WordPress 7.0+)
+if (function_exists('register_block_type')) {
+    register_block_type('my-plugin/featured-post', [
+        'render_callback' => function($attributes, $content, $block) {
+            $post_id = isset($attributes['postId']) ? absint($attributes['postId']) : 0;
+            
+            if (!$post_id) {
+                $post_id = get_the_ID();
+            }
+            
+            $post = get_post($post_id);
+            
+            if (!$post) {
+                return '';
+            }
+            
+            $title = esc_html($post->post_title);
+            $excerpt = esc_html(get_the_excerpt($post));
+            
+            return sprintf(
+                '<div class="featured-post"><h2>%s</h2><p>%s</p></div>',
+                $title,
+                $excerpt
+            );
+        },
+        'attributes' => [
+            'postId' => ['type' => 'integer', 'default' => 0],
+            'showExcerpt' => ['type' => 'boolean', 'default' => true]
+        ],
+    ]);
+}
+```
+
+#### Disable Collaboration (if needed)
+```javascript
+// Disable RTC for specific post types
+import { addFilter } from '@wordpress/hooks';
+
+addFilter(
+    'sync.providers',
+    'my-plugin/disable-collab',
+    () => []
+);
+```
+
+### Phase 9: Testing
 
 #### Skills to Invoke
 - `test-automator` - Test automation
@@ -160,6 +431,12 @@ Use @wordpress-penetration-testing to audit plugin security
 4. Test with WordPress test suite
 5. Configure CI
 
+#### WordPress 7.0 Testing Priorities
+- Test RTC compatibility
+- Verify AI connector functionality
+- Validate DataViews integration
+- Test Interactivity API with watch()
+
 #### Copy-Paste Prompts
 ```
 Use @test-automator to set up plugin testing
@@ -183,10 +460,25 @@ plugin-name/
 │   ├── class-plugin-public.php
 │   ├── css/
 │   └── js/
+├── blocks/           # PHP-only blocks (WP 7.0)
+├── abilities/        # Abilities API
+├── ai/               # AI Connector integration
 ├── languages/
 └── vendor/
 ```
 
+## WordPress 7.0 Compatibility Checklist
+
+- [ ] PHP 7.4+ requirement documented
+- [ ] Post meta registered with `show_in_rest => true` for RTC
+- [ ] Meta boxes migrated to block-based UIs
+- [ ] AI Connector integration tested
+- [ ] Abilities API registered (if applicable)
+- [ ] DataViews integration tested (if applicable)
+- [ ] Interactivity API uses `watch()` not `effect`
+- [ ] Tested with iframed editor
+- [ ] Collaboration fallback works (post locking)
+
 ## Quality Gates
 
 - [ ] Plugin activates without errors
@@ -195,6 +487,7 @@ plugin-name/
 - [ ] Security measures implemented
 - [ ] Tests passing
 - [ ] Documentation complete
+- [ ] WordPress 7.0 compatibility verified
 
 ## Related Workflow Bundles