opencode-skills-antigravity 1.0.12 → 1.0.13

package/bundled-skills/snowflake-development/SKILL.md

@@ -0,0 +1,228 @@
+---
+name: snowflake-development
+description: "Comprehensive Snowflake development assistant covering SQL best practices, data pipeline design (Dynamic Tables, Streams, Tasks, Snowpipe), Cortex AI functions, Cortex Agents, Snowpark Python, dbt integration, performance tuning, and security hardening."
+category: data-engineering
+risk: safe
+source: community
+date_added: "2026-03-24"
+---
+
+# Snowflake Development
+
+You are a Snowflake development expert. Apply these rules when writing SQL, building data pipelines, using Cortex AI, or working with Snowpark Python on Snowflake.
+
+## SQL Best Practices
+
+### Naming and Style
+
+- Use `snake_case` for all identifiers. Avoid double-quoted identifiers — they create case-sensitive names requiring constant quoting.
+- Use CTEs (`WITH` clauses) over nested subqueries.
+- Use `CREATE OR REPLACE` for idempotent DDL.
+- Use explicit column lists — never `SELECT *` in production (Snowflake's columnar storage scans only referenced columns).
+
+### Stored Procedures — Colon Prefix Rule
+
+In SQL stored procedures (BEGIN...END blocks), variables and parameters **must** use the colon `:` prefix inside SQL statements. Without it, Snowflake raises "invalid identifier" errors.
+
+BAD:
+```sql
+CREATE PROCEDURE my_proc(p_id INT) RETURNS STRING LANGUAGE SQL AS
+BEGIN
+    LET result STRING;
+    SELECT name INTO result FROM users WHERE id = p_id;
+    RETURN result;
+END;
+```
+
+GOOD:
+```sql
+CREATE PROCEDURE my_proc(p_id INT) RETURNS STRING LANGUAGE SQL AS
+BEGIN
+    LET result STRING;
+    SELECT name INTO :result FROM users WHERE id = :p_id;
+    RETURN result;
+END;
+```
+
+### Semi-Structured Data
+
+- VARIANT, OBJECT, ARRAY for JSON/Avro/Parquet/ORC.
+- Access nested fields: `src:customer.name::STRING`. Always cast: `src:price::NUMBER(10,2)`.
+- VARIANT null vs SQL NULL: JSON `null` is stored as `"null"`. Use `STRIP_NULL_VALUE = TRUE` on load.
+- Flatten arrays: `SELECT f.value:name::STRING FROM my_table, LATERAL FLATTEN(input => src:items) f;`
+
+### MERGE for Upserts
+
+```sql
+MERGE INTO target t USING source s ON t.id = s.id
+WHEN MATCHED THEN UPDATE SET t.name = s.name, t.updated_at = CURRENT_TIMESTAMP()
+WHEN NOT MATCHED THEN INSERT (id, name, updated_at) VALUES (s.id, s.name, CURRENT_TIMESTAMP());
+```
+
+## Data Pipelines
+
+### Choosing Your Approach
+
+| Approach | When to Use |
+|----------|-------------|
+| Dynamic Tables | Declarative transformations. **Default choice.** Define the query, Snowflake handles refresh. |
+| Streams + Tasks | Imperative CDC. Use for procedural logic, stored procedure calls. |
+| Snowpipe | Continuous file loading from S3/GCS/Azure. |
+
+### Dynamic Tables
+
+```sql
+CREATE OR REPLACE DYNAMIC TABLE cleaned_events
+    TARGET_LAG = '5 minutes'
+    WAREHOUSE = transform_wh
+    AS
+    SELECT event_id, event_type, user_id, event_timestamp
+    FROM raw_events
+    WHERE event_type IS NOT NULL;
+```
+
+Key rules:
+- Set `TARGET_LAG` progressively: tighter at top, looser at bottom.
+- Incremental DTs **cannot** depend on Full refresh DTs.
+- `SELECT *` breaks on schema changes — use explicit column lists.
+- Change tracking must stay enabled on base tables.
+- Views cannot sit between two Dynamic Tables.
+
+### Streams and Tasks
+
+```sql
+CREATE OR REPLACE STREAM raw_stream ON TABLE raw_events;
+
+CREATE OR REPLACE TASK process_events
+    WAREHOUSE = transform_wh
+    SCHEDULE = 'USING CRON 0 */1 * * * America/Los_Angeles'
+    WHEN SYSTEM$STREAM_HAS_DATA('raw_stream')
+    AS INSERT INTO cleaned_events SELECT ... FROM raw_stream;
+
+-- Tasks start SUSPENDED — you MUST resume them
+ALTER TASK process_events RESUME;
+```
+
+## Cortex AI
+
+### Function Reference
+
+| Function | Purpose |
+|----------|---------|
+| `AI_COMPLETE` | LLM completion (text, images, documents) |
+| `AI_CLASSIFY` | Classify into categories (up to 500 labels) |
+| `AI_FILTER` | Boolean filter on text/images |
+| `AI_EXTRACT` | Structured extraction from text/images/documents |
+| `AI_SENTIMENT` | Sentiment score (-1 to 1) |
+| `AI_PARSE_DOCUMENT` | OCR or layout extraction |
+| `AI_REDACT` | PII removal |
+
+**Deprecated (do NOT use):** `COMPLETE`, `CLASSIFY_TEXT`, `EXTRACT_ANSWER`, `PARSE_DOCUMENT`, `SUMMARIZE`, `TRANSLATE`, `SENTIMENT`, `EMBED_TEXT_768`.
+
+### TO_FILE — Common Error Source
+
+Stage path and filename are **SEPARATE** arguments:
+
+```sql
+-- BAD: TO_FILE('@stage/file.pdf')
+-- GOOD:
+TO_FILE('@db.schema.mystage', 'invoice.pdf')
+```
+
+### Use AI_CLASSIFY for Classification (Not AI_COMPLETE)
+
+```sql
+SELECT AI_CLASSIFY(ticket_text,
+    ['billing', 'technical', 'account']):labels[0]::VARCHAR AS category
+FROM tickets;
+```
+
+### Cortex Agents
+
+```sql
+CREATE OR REPLACE AGENT my_db.my_schema.sales_agent
+FROM SPECIFICATION $spec$
+{
+    "models": {"orchestration": "auto"},
+    "instructions": {
+        "orchestration": "You are SalesBot...",
+        "response": "Be concise."
+    },
+    "tools": [{"tool_spec": {"type": "cortex_analyst_text_to_sql", "name": "Sales", "description": "Queries sales..."}}],
+    "tool_resources": {"Sales": {"semantic_model_file": "@stage/model.yaml"}}
+}
+$spec$;
+```
+
+Agent rules:
+- Use `$spec$` delimiter (not `$$`).
+- `models` must be an object, not an array.
+- `tool_resources` is a separate top-level object, not nested inside tools.
+- Do NOT include empty/null values in edit specs — clears existing values.
+- Tool descriptions are the #1 quality factor.
+- Never modify production agents directly — clone first.
+
+## Snowpark Python
+
+```python
+from snowflake.snowpark import Session
+import os
+
+session = Session.builder.configs({
+    "account": os.environ["SNOWFLAKE_ACCOUNT"],
+    "user": os.environ["SNOWFLAKE_USER"],
+    "password": os.environ["SNOWFLAKE_PASSWORD"],
+    "role": "my_role", "warehouse": "my_wh",
+    "database": "my_db", "schema": "my_schema"
+}).create()
+```
+
+- Never hardcode credentials.
+- DataFrames are lazy — executed on `collect()`/`show()`.
+- Do NOT use `collect()` on large DataFrames — process server-side.
+- Use **vectorized UDFs** (10-100x faster) for batch/ML workloads instead of scalar UDFs.
+
+## dbt on Snowflake
+
+Dynamic table materialization (streaming/near-real-time marts):
+```sql
+{{ config(materialized='dynamic_table', snowflake_warehouse='transforming', target_lag='1 hour') }}
+```
+
+Incremental materialization (large fact tables):
+```sql
+{{ config(materialized='incremental', unique_key='event_id') }}
+```
+
+Snowflake-specific configs (combine with any materialization):
+```sql
+{{ config(transient=true, copy_grants=true, query_tag='team_daily') }}
+```
+
+- Do NOT use `{{ this }}` without `{% if is_incremental() %}` guard.
+- Use `dynamic_table` materialization for streaming/near-real-time marts.
+
+## Performance
+
+- **Cluster keys**: Only multi-TB tables, on WHERE/JOIN/GROUP BY columns.
+- **Search Optimization**: `ALTER TABLE t ADD SEARCH OPTIMIZATION ON EQUALITY(col);`
+- **Warehouse sizing**: Start X-Small, scale up. `AUTO_SUSPEND = 60`, `AUTO_RESUME = TRUE`.
+- **Separate warehouses** per workload.
+- Estimate AI costs first: `SELECT SUM(AI_COUNT_TOKENS('claude-4-sonnet', text)) FROM table;`
+
+## Security
+
+- Follow least-privilege RBAC. Use database roles for object-level grants.
+- Audit ACCOUNTADMIN regularly: `SHOW GRANTS OF ROLE ACCOUNTADMIN;`
+- Use network policies for IP allowlisting.
+- Use masking policies for PII columns and row access policies for multi-tenant isolation.
+
+## Common Error Patterns
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| "Object does not exist" | Wrong context or missing grants | Fully qualify names, check grants |
+| "Invalid identifier" in proc | Missing colon prefix | Use `:variable_name` |
+| "Numeric value not recognized" | VARIANT not cast | `src:field::NUMBER(10,2)` |
+| Task not running | Forgot to resume | `ALTER TASK ... RESUME` |
+| DT refresh failing | Schema change or tracking disabled | Use explicit columns, check change tracking |

package/bundled-skills/wordpress/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wordpress
-description: "Complete WordPress development workflow covering theme development, plugin creation, WooCommerce integration, performance optimization, and security hardening."
+description: "Complete WordPress development workflow covering theme development, plugin creation, WooCommerce integration, performance optimization, and security hardening. Includes WordPress 7.0 features: Real-Time Collaboration, AI Connectors, Abilities API, DataViews, and PHP-only blocks."
 category: workflow-bundle
 risk: safe
 source: personal
@@ -13,6 +13,54 @@ date_added: "2026-02-27"
 
 Comprehensive WordPress development workflow covering theme development, plugin creation, WooCommerce integration, performance optimization, and security. This bundle orchestrates skills for building production-ready WordPress sites and applications.
 
+## WordPress 7.0 Features (Backward Compatible)
+
+WordPress 7.0 (April 9, 2026) introduces significant features while maintaining backward compatibility:
+
+### Real-Time Collaboration (RTC)
+- Multiple users can edit simultaneously using Yjs CRDT
+- HTTP polling provider (configurable via `WP_COLLABORATION_MAX_USERS`)
+- Custom transport via `sync.providers` filter
+- **Backward Compatibility**: Falls back to post locking when legacy meta boxes detected
+
+### AI Connectors API
+- Provider-agnostic AI interface in core (`wp_ai_client_prompt()`)
+- Settings > Connectors for centralized API credential management
+- Official providers: OpenAI, Anthropic Claude, Google Gemini
+- **Backward Compatibility**: Works with WordPress 6.9+ via plugin
+
+### Abilities API (Stable in 7.0)
+- Standardized capability declaration system
+- REST API endpoints: `/wp-json/abilities/v1/manifest`
+- MCP adapter for AI agent integration
+- **Backward Compatibility**: Can be used as Composer package in 6.x
+
+### DataViews & DataForm
+- Replaces WP_List_Table on Posts, Pages, Media screens
+- New layouts: table, grid, list, activity
+- Client-side validation (pattern, minLength, maxLength, min, max)
+- **Backward Compatibility**: Plugins using old hooks still work
+
+### PHP-Only Block Registration
+- Register blocks entirely via PHP without JavaScript
+- Auto-generated Inspector controls
+- **Backward Compatibility**: Existing JS blocks continue to work
+
+### Interactivity API Updates
+- `watch()` replaces `effect` from @preact/signals
+- State navigation changes
+- **Backward Compatibility**: Old syntax deprecated but functional
+
+### Admin Refresh
+- New default color scheme
+- View transitions between admin screens
+- **Backward Compatibility**: CSS-level changes, no breaking changes
+
+### Pattern Editing
+- ContentOnly mode defaults for unsynced patterns
+- `disableContentOnlyForUnsyncedPatterns` setting
+- **Backward Compatibility**: Existing patterns work
+
 ## When to Use This Workflow
 
 Use this workflow when:
@@ -22,6 +70,7 @@ Use this workflow when:
 - Setting up WooCommerce stores
 - Optimizing WordPress performance
 - Hardening WordPress security
+- Implementing WordPress 7.0 features (RTC, AI, DataViews)
 
 ## Workflow Phases
 
@@ -33,11 +82,21 @@ Use this workflow when:
 
 #### Actions
 1. Set up local development environment (LocalWP, Docker, or Valet)
-2. Install WordPress
+2. Install WordPress (recommend 7.0+ for new projects)
 3. Configure development database
 4. Set up version control
 5. Configure wp-config.php for development
 
+#### WordPress 7.0 Configuration
+```php
+// wp-config.php - Collaboration settings
+define('WP_COLLABORATION_MAX_USERS', 5);
+
+// AI Connector is enabled by installing a provider plugin
+// (e.g., OpenAI, Anthropic Claude, or Google Gemini connector)
+// No constant needed - configure via Settings > Connectors in admin
+```
+
 #### Copy-Paste Prompts
 ```
 Use @app-builder to scaffold a new WordPress project with modern tooling
@@ -59,6 +118,13 @@ Use @app-builder to scaffold a new WordPress project with modern tooling
 5. Add custom post types and taxonomies
 6. Implement theme customization options
 7. Add responsive design
+8. Test with WordPress 7.0 admin refresh
+
+#### WordPress 7.0 Theme Considerations
+- Block API v3 now reference model
+- Pseudo-element support in theme.json
+- Global Styles custom CSS honors block-defined selectors
+- View transitions for admin navigation
 
 #### Theme Structure
 ```
@@ -108,6 +174,56 @@ Use @tailwind-patterns to style WordPress theme with modern CSS
 6. Implement REST API endpoints
 7. Add settings and options pages
 
+#### WordPress 7.0 Plugin Considerations
+- **RTC Compatibility**: Register post meta with `show_in_rest => true`
+- **AI Integration**: Use `wp_ai_client_prompt()` for AI features
+- **DataViews**: Consider new admin UI patterns
+- **Meta Boxes**: Migrate to block-based UIs for collaboration support
+
+#### RTC-Compatible Post Meta Registration
+```php
+register_post_meta('post', 'custom_field', [
+    'type' => 'string',
+    'single' => true,
+    'show_in_rest' => true,  // Required for RTC
+    'sanitize_callback' => 'sanitize_text_field',
+]);
+```
+
+#### AI Connector Example
+```php
+// Using WordPress 7.0 AI Connector
+// Note: Requires an AI provider plugin (OpenAI, Claude, or Gemini) to be installed and configured
+
+// Basic text generation
+$response = wp_ai_client_prompt('Summarize this content.')
+    ->generate_text();
+
+// With temperature for deterministic output
+$response = wp_ai_client_prompt('Summarize this content.')
+    ->using_temperature(0.2)
+    ->generate_text();
+
+// With model preference (tries first available in list)
+$response = wp_ai_client_prompt('Summarize this content.')
+    ->using_model_preference('gpt-4', 'claude-3-opus', 'gemini-2-pro')
+    ->generate_text();
+
+// For JSON structured output
+$schema = [
+    'type' => 'object',
+    'properties' => [
+        'summary' => ['type' => 'string'],
+        'keywords' => ['type' => 'array', 'items' => ['type' => 'string']]
+    ],
+    'required' => ['summary']
+];
+$response = wp_ai_client_prompt('Analyze this content and return JSON.')
+    ->using_system_instruction('You are a content analyzer.')
+    ->as_json_response($schema)
+    ->generate_text();
+```
+
 #### Plugin Structure
 ```
 plugin-name/
@@ -150,6 +266,12 @@ Use @backend-dev-guidelines to create a WordPress plugin with proper architectur
 7. Implement subscription products
 8. Add custom email templates
 
+#### WordPress 7.0 + WooCommerce Considerations
+- Test checkout with new admin interfaces
+- AI connectors for product descriptions
+- DataViews for order management screens
+- RTC for collaborative order editing
+
 #### Copy-Paste Prompts
 ```
 Use @payment-integration to set up WooCommerce with Stripe
@@ -175,6 +297,12 @@ Use @billing-automation to create subscription products in WooCommerce
 7. Configure OPcache
 8. Set up Redis/Memcached
 
+#### WordPress 7.0 Performance
+- Client-side media processing
+- Font Library enabled for all themes
+- Responsive grid block optimizations
+- View transitions reduce perceived load time
+
 #### Performance Checklist
 - [ ] Page load time < 3 seconds
 - [ ] Time to First Byte < 200ms
@@ -204,8 +332,14 @@ Use @web-performance-optimization to audit and improve WordPress performance
 7. Configure security logging
 8. Set up malware scanning
 
+#### WordPress 7.0 Security Considerations
+- PHP 7.4 minimum (drops 7.2/7.3 support)
+- Test Abilities API permission boundaries
+- Verify collaboration data isolation
+- AI connector credential security
+
 #### Security Checklist
-- [ ] WordPress core updated
+- [ ] WordPress core updated (7.0+ recommended)
 - [ ] All plugins/themes updated
 - [ ] Strong passwords enforced
 - [ ] Two-factor authentication enabled
@@ -240,6 +374,13 @@ Use @security-auditor to perform comprehensive security review
 6. Performance testing
 7. Security testing
 
+#### WordPress 7.0 Testing Priorities
+- Test with iframed post editor
+- Verify DataViews integration
+- Test collaboration (RTC) workflows
+- Validate AI connector functionality
+- Test Interactivity API with watch()
+
 #### Copy-Paste Prompts
 ```
 Use @playwright-skill to create E2E tests for WordPress site
@@ -269,7 +410,7 @@ Use @deployment-engineer to set up WordPress deployment pipeline
 
 ## WordPress-Specific Workflows
 
-### Custom Post Type Development
+### Custom Post Type Development (RTC-Compatible)
 ```php
 register_post_type('book', [
     'labels' => [...],
@@ -277,6 +418,15 @@ register_post_type('book', [
     'has_archive' => true,
     'supports' => ['title', 'editor', 'thumbnail', 'excerpt'],
     'menu_icon' => 'dashicons-book',
+    'show_in_rest' => true,  // Enable for RTC
+]);
+
+// Register meta with REST API for collaboration
+register_post_meta('book', 'isbn', [
+    'type' => 'string',
+    'single' => true,
+    'show_in_rest' => true,
+    'sanitize_callback' => 'sanitize_text_field',
 ]);
 ```
 
@@ -291,6 +441,130 @@ add_action('rest_api_init', function() {
 });
 ```
 
+### WordPress 7.0 AI Connector Usage
+```php
+// Auto-generate post excerpt with AI
+add_action('save_post', function($post_id, $post) {
+    if (wp_is_post_autosave($post_id) || wp_is_post_revision($post_id)) {
+        return;
+    }
+    
+    // Skip if excerpt already exists
+    if (!empty($post->post_excerpt)) {
+        return;
+    }
+    
+    $content = strip_tags($post->post_content);
+    if (empty($content)) {
+        return;
+    }
+    
+    // Check if AI client is available
+    if (!function_exists('wp_ai_client_prompt')) {
+        return;
+    }
+    
+    // Build prompt with input
+    $result = wp_ai_client_prompt(
+        'Create a brief 2-sentence summary of this content: ' . substr($content, 0, 1000)
+    );
+    
+    if (is_wp_error($result)) {
+        return; // Silently fail - don't block post saving
+    }
+    
+    // Use temperature for consistent output
+    $result->using_temperature(0.3);
+    $summary = $result->generate_text();
+    
+    if ($summary && !is_wp_error($summary)) {
+        wp_update_post([
+            'ID' => $post_id,
+            'post_excerpt' => sanitize_textarea_field($summary)
+        ]);
+    }
+}, 10, 2);
+```
+
+### PHP-Only Block Registration (WordPress 7.0)
+```php
+// Register block entirely in PHP
+register_block_type('my-plugin/hello-world', [
+    'render_callback' => function($attributes, $content) {
+        return '<p class="hello-world">Hello, World!</p>';
+    },
+    'attributes' => [
+        'message' => ['type' => 'string', 'default' => 'Hello!']
+    ],
+]);
+```
+
+### Abilities API Registration
+```php
+// Register ability category on correct 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 correct hook
+add_action('wp_abilities_api_init', function() {
+    wp_register_ability('my-plugin/generate-summary', [
+        'label' => __('Generate Post Summary', 'my-plugin'),
+        'description' => __('Creates an AI-powered summary of a post', 'my-plugin'),
+        'category' => 'content-creation',
+        'input_schema' => [
+            'type' => 'object',
+            'properties' => [
+                'post_id' => ['type' => 'integer', 'description' => 'The post ID to summarize']
+            ],
+            'required' => ['post_id']
+        ],
+        'output_schema' => [
+            'type' => 'object',
+            'properties' => [
+                'summary' => ['type' => 'string', 'description' => 'The generated summary']
+            ]
+        ],
+        'execute_callback' => 'my_plugin_generate_summary_handler',
+        'permission_callback' => function() {
+            return current_user_can('edit_posts');
+        }
+    ]);
+});
+
+// Handler function for the ability
+function my_plugin_generate_summary_handler($input) {
+    $post_id = isset($input['post_id']) ? absint($input['post_id']) : 0;
+    $post = get_post($post_id);
+    
+    if (!$post) {
+        return new WP_Error('invalid_post', 'Post not found');
+    }
+    
+    $content = strip_tags($post->post_content);
+    if (empty($content)) {
+        return ['summary' => ''];
+    }
+    
+    if (!function_exists('wp_ai_client_prompt')) {
+        return new WP_Error('ai_unavailable', 'AI client not available');
+    }
+    
+    $result = wp_ai_client_prompt('Summarize in 2 sentences: ' . substr($content, 0, 1000))
+        ->using_temperature(0.3)
+        ->generate_text();
+    
+    if (is_wp_error($result)) {
+        return $result;
+    }
+    
+    return ['summary' => sanitize_textarea_field($result)];
+}
+```
+
 ### WooCommerce Custom Product Type
 ```php
 add_action('init', function() {
@@ -309,6 +583,7 @@ Before moving to next phase, verify:
 - [ ] Cross-browser tested
 - [ ] Mobile responsive verified
 - [ ] Accessibility checked (WCAG 2.1)
+- [ ] WordPress 7.0 compatibility verified (for new projects)
 
 ## Related Workflow Bundles
 
@@ -316,3 +591,5 @@ Before moving to next phase, verify:
 - `security-audit` - Security testing
 - `testing-qa` - Testing workflow
 - `ecommerce` - E-commerce development
+
+(End of file - total 440 lines)