agentic-flow 1.9.0 → 1.9.2

package/.claude/skills/flow-nexus-platform/SKILL.md

@@ -1,1157 +0,0 @@
----
-name: flow-nexus-platform
-description: Comprehensive Flow Nexus platform management - authentication, sandboxes, app deployment, payments, and challenges
-category: platform
-version: 1.0.0
-author: Flow Nexus
-tags: [authentication, sandboxes, deployment, payments, gamification, cloud]
----
-
-# Flow Nexus Platform Management
-
-Comprehensive platform management for Flow Nexus - covering authentication, sandbox execution, app deployment, credit management, and coding challenges.
-
-## Table of Contents
-1. [Authentication & User Management](#authentication--user-management)
-2. [Sandbox Management](#sandbox-management)
-3. [App Store & Deployment](#app-store--deployment)
-4. [Payments & Credits](#payments--credits)
-5. [Challenges & Achievements](#challenges--achievements)
-6. [Storage & Real-time](#storage--real-time)
-7. [System Utilities](#system-utilities)
-
----
-
-## Authentication & User Management
-
-### Registration & Login
-
-**Register New Account**
-```javascript
-mcp__flow-nexus__user_register({
-  email: "user@example.com",
-  password: "secure_password",
-  full_name: "Your Name",
-  username: "unique_username" // optional
-})
-```
-
-**Login**
-```javascript
-mcp__flow-nexus__user_login({
-  email: "user@example.com",
-  password: "your_password"
-})
-```
-
-**Check Authentication Status**
-```javascript
-mcp__flow-nexus__auth_status({ detailed: true })
-```
-
-**Logout**
-```javascript
-mcp__flow-nexus__user_logout()
-```
-
-### Password Management
-
-**Request Password Reset**
-```javascript
-mcp__flow-nexus__user_reset_password({
-  email: "user@example.com"
-})
-```
-
-**Update Password with Token**
-```javascript
-mcp__flow-nexus__user_update_password({
-  token: "reset_token_from_email",
-  new_password: "new_secure_password"
-})
-```
-
-**Verify Email**
-```javascript
-mcp__flow-nexus__user_verify_email({
-  token: "verification_token_from_email"
-})
-```
-
-### Profile Management
-
-**Get User Profile**
-```javascript
-mcp__flow-nexus__user_profile({
-  user_id: "your_user_id"
-})
-```
-
-**Update Profile**
-```javascript
-mcp__flow-nexus__user_update_profile({
-  user_id: "your_user_id",
-  updates: {
-    full_name: "Updated Name",
-    bio: "AI Developer and researcher",
-    github_username: "yourusername",
-    twitter_handle: "@yourhandle"
-  }
-})
-```
-
-**Get User Statistics**
-```javascript
-mcp__flow-nexus__user_stats({
-  user_id: "your_user_id"
-})
-```
-
-**Upgrade User Tier**
-```javascript
-mcp__flow-nexus__user_upgrade({
-  user_id: "your_user_id",
-  tier: "pro" // pro, enterprise
-})
-```
-
----
-
-## Sandbox Management
-
-### Create & Configure Sandboxes
-
-**Create Sandbox**
-```javascript
-mcp__flow-nexus__sandbox_create({
-  template: "node", // node, python, react, nextjs, vanilla, base, claude-code
-  name: "my-sandbox",
-  env_vars: {
-    API_KEY: "your_api_key",
-    NODE_ENV: "development",
-    DATABASE_URL: "postgres://..."
-  },
-  install_packages: ["express", "cors", "dotenv"],
-  startup_script: "npm run dev",
-  timeout: 3600, // seconds
-  metadata: {
-    project: "my-project",
-    environment: "staging"
-  }
-})
-```
-
-**Configure Existing Sandbox**
-```javascript
-mcp__flow-nexus__sandbox_configure({
-  sandbox_id: "sandbox_id",
-  env_vars: {
-    NEW_VAR: "value"
-  },
-  install_packages: ["axios", "lodash"],
-  run_commands: ["npm run migrate", "npm run seed"],
-  anthropic_key: "sk-ant-..." // For Claude Code integration
-})
-```
-
-### Execute Code
-
-**Run Code in Sandbox**
-```javascript
-mcp__flow-nexus__sandbox_execute({
-  sandbox_id: "sandbox_id",
-  code: `
-    console.log('Hello from sandbox!');
-    const result = await fetch('https://api.example.com/data');
-    const data = await result.json();
-    return data;
-  `,
-  language: "javascript",
-  capture_output: true,
-  timeout: 60, // seconds
-  working_dir: "/app",
-  env_vars: {
-    TEMP_VAR: "override"
-  }
-})
-```
-
-### Manage Sandboxes
-
-**List Sandboxes**
-```javascript
-mcp__flow-nexus__sandbox_list({
-  status: "running" // running, stopped, all
-})
-```
-
-**Get Sandbox Status**
-```javascript
-mcp__flow-nexus__sandbox_status({
-  sandbox_id: "sandbox_id"
-})
-```
-
-**Upload File to Sandbox**
-```javascript
-mcp__flow-nexus__sandbox_upload({
-  sandbox_id: "sandbox_id",
-  file_path: "/app/config/database.json",
-  content: JSON.stringify(databaseConfig, null, 2)
-})
-```
-
-**Get Sandbox Logs**
-```javascript
-mcp__flow-nexus__sandbox_logs({
-  sandbox_id: "sandbox_id",
-  lines: 100 // max 1000
-})
-```
-
-**Stop Sandbox**
-```javascript
-mcp__flow-nexus__sandbox_stop({
-  sandbox_id: "sandbox_id"
-})
-```
-
-**Delete Sandbox**
-```javascript
-mcp__flow-nexus__sandbox_delete({
-  sandbox_id: "sandbox_id"
-})
-```
-
-### Sandbox Templates
-
-- **node**: Node.js environment with npm
-- **python**: Python 3.x with pip
-- **react**: React development setup
-- **nextjs**: Next.js full-stack framework
-- **vanilla**: Basic HTML/CSS/JS
-- **base**: Minimal Linux environment
-- **claude-code**: Claude Code integrated environment
-
-### Common Sandbox Patterns
-
-**API Development Sandbox**
-```javascript
-mcp__flow-nexus__sandbox_create({
-  template: "node",
-  name: "api-development",
-  install_packages: [
-    "express",
-    "cors",
-    "helmet",
-    "dotenv",
-    "jsonwebtoken",
-    "bcrypt"
-  ],
-  env_vars: {
-    PORT: "3000",
-    NODE_ENV: "development"
-  },
-  startup_script: "npm run dev"
-})
-```
-
-**Machine Learning Sandbox**
-```javascript
-mcp__flow-nexus__sandbox_create({
-  template: "python",
-  name: "ml-training",
-  install_packages: [
-    "numpy",
-    "pandas",
-    "scikit-learn",
-    "matplotlib",
-    "tensorflow"
-  ],
-  env_vars: {
-    CUDA_VISIBLE_DEVICES: "0"
-  }
-})
-```
-
-**Full-Stack Development**
-```javascript
-mcp__flow-nexus__sandbox_create({
-  template: "nextjs",
-  name: "fullstack-app",
-  install_packages: [
-    "prisma",
-    "@prisma/client",
-    "next-auth",
-    "zod"
-  ],
-  env_vars: {
-    DATABASE_URL: "postgresql://...",
-    NEXTAUTH_SECRET: "secret"
-  }
-})
-```
-
----
-
-## App Store & Deployment
-
-### Browse & Search
-
-**Search Applications**
-```javascript
-mcp__flow-nexus__app_search({
-  search: "authentication api",
-  category: "backend",
-  featured: true,
-  limit: 20
-})
-```
-
-**Get App Details**
-```javascript
-mcp__flow-nexus__app_get({
-  app_id: "app_id"
-})
-```
-
-**List Templates**
-```javascript
-mcp__flow-nexus__app_store_list_templates({
-  category: "web-api",
-  tags: ["express", "jwt", "typescript"],
-  limit: 20
-})
-```
-
-**Get Template Details**
-```javascript
-mcp__flow-nexus__template_get({
-  template_name: "express-api-starter",
-  template_id: "template_id" // alternative
-})
-```
-
-**List All Available Templates**
-```javascript
-mcp__flow-nexus__template_list({
-  category: "backend",
-  template_type: "starter",
-  featured: true,
-  limit: 50
-})
-```
-
-### Publish Applications
-
-**Publish App to Store**
-```javascript
-mcp__flow-nexus__app_store_publish_app({
-  name: "JWT Authentication Service",
-  description: "Production-ready JWT authentication microservice with refresh tokens",
-  category: "backend",
-  version: "1.0.0",
-  source_code: sourceCodeString,
-  tags: ["auth", "jwt", "express", "typescript", "security"],
-  metadata: {
-    author: "Your Name",
-    license: "MIT",
-    repository: "github.com/username/repo",
-    homepage: "https://yourapp.com",
-    documentation: "https://docs.yourapp.com"
-  }
-})
-```
-
-**Update Application**
-```javascript
-mcp__flow-nexus__app_update({
-  app_id: "app_id",
-  updates: {
-    version: "1.1.0",
-    description: "Added OAuth2 support",
-    tags: ["auth", "jwt", "oauth2", "express"],
-    source_code: updatedSourceCode
-  }
-})
-```
-
-### Deploy Templates
-
-**Deploy Template**
-```javascript
-mcp__flow-nexus__template_deploy({
-  template_name: "express-api-starter",
-  deployment_name: "my-production-api",
-  variables: {
-    api_key: "your_api_key",
-    database_url: "postgres://user:pass@host:5432/db",
-    redis_url: "redis://localhost:6379"
-  },
-  env_vars: {
-    NODE_ENV: "production",
-    PORT: "8080",
-    LOG_LEVEL: "info"
-  }
-})
-```
-
-### Analytics & Management
-
-**Get App Analytics**
-```javascript
-mcp__flow-nexus__app_analytics({
-  app_id: "your_app_id",
-  timeframe: "30d" // 24h, 7d, 30d, 90d
-})
-```
-
-**View Installed Apps**
-```javascript
-mcp__flow-nexus__app_installed({
-  user_id: "your_user_id"
-})
-```
-
-**Get Market Statistics**
-```javascript
-mcp__flow-nexus__market_data()
-```
-
-### App Categories
-
-- **web-api**: RESTful APIs and microservices
-- **frontend**: React, Vue, Angular applications
-- **full-stack**: Complete end-to-end applications
-- **cli-tools**: Command-line utilities
-- **data-processing**: ETL pipelines and analytics
-- **ml-models**: Pre-trained machine learning models
-- **blockchain**: Web3 and blockchain applications
-- **mobile**: React Native and mobile apps
-
-### Publishing Best Practices
-
-1. **Documentation**: Include comprehensive README with setup instructions
-2. **Examples**: Provide usage examples and sample configurations
-3. **Testing**: Include test suite and CI/CD configuration
-4. **Versioning**: Use semantic versioning (MAJOR.MINOR.PATCH)
-5. **Licensing**: Add clear license information (MIT, Apache, etc.)
-6. **Deployment**: Include Docker/docker-compose configurations
-7. **Migrations**: Provide upgrade guides for version updates
-8. **Security**: Document security considerations and best practices
-
-### Revenue Sharing
-
-- Earn rUv credits when others deploy your templates
-- Set pricing (0 for free, or credits for premium)
-- Track usage and earnings via analytics
-- Withdraw credits or use for Flow Nexus services
-
----
-
-## Payments & Credits
-
-### Balance & Credits
-
-**Check Credit Balance**
-```javascript
-mcp__flow-nexus__check_balance()
-```
-
-**Check rUv Balance**
-```javascript
-mcp__flow-nexus__ruv_balance({
-  user_id: "your_user_id"
-})
-```
-
-**View Transaction History**
-```javascript
-mcp__flow-nexus__ruv_history({
-  user_id: "your_user_id",
-  limit: 100
-})
-```
-
-**Get Payment History**
-```javascript
-mcp__flow-nexus__get_payment_history({
-  limit: 50
-})
-```
-
-### Purchase Credits
-
-**Create Payment Link**
-```javascript
-mcp__flow-nexus__create_payment_link({
-  amount: 50 // USD, minimum $10
-})
-// Returns secure Stripe payment URL
-```
-
-### Auto-Refill Configuration
-
-**Enable Auto-Refill**
-```javascript
-mcp__flow-nexus__configure_auto_refill({
-  enabled: true,
-  threshold: 100,  // Refill when credits drop below 100
-  amount: 50       // Purchase $50 worth of credits
-})
-```
-
-**Disable Auto-Refill**
-```javascript
-mcp__flow-nexus__configure_auto_refill({
-  enabled: false
-})
-```
-
-### Credit Pricing
-
-**Service Costs:**
-- **Swarm Operations**: 1-10 credits/hour
-- **Sandbox Execution**: 0.5-5 credits/hour
-- **Neural Training**: 5-50 credits/job
-- **Workflow Runs**: 0.1-1 credit/execution
-- **Storage**: 0.01 credits/GB/day
-- **API Calls**: 0.001-0.01 credits/request
-
-### Earning Credits
-
-**Ways to Earn:**
-1. **Complete Challenges**: 10-500 credits per challenge
-2. **Publish Templates**: Earn when others deploy (you set pricing)
-3. **Referral Program**: Bonus credits for user invites
-4. **Daily Login**: Small daily bonus (5-10 credits)
-5. **Achievements**: Unlock milestone rewards (50-1000 credits)
-6. **App Store Sales**: Revenue share from paid templates
-
-**Earn Credits Programmatically**
-```javascript
-mcp__flow-nexus__app_store_earn_ruv({
-  user_id: "your_user_id",
-  amount: 100,
-  reason: "Completed expert algorithm challenge",
-  source: "challenge" // challenge, app_usage, referral, etc.
-})
-```
-
-### Subscription Tiers
-
-**Free Tier**
-- 100 free credits monthly
-- Basic sandbox access (2 concurrent)
-- Limited swarm agents (3 max)
-- Community support
-- 1GB storage
-
-**Pro Tier ($29/month)**
-- 1000 credits monthly
-- Priority sandbox access (10 concurrent)
-- Unlimited swarm agents
-- Advanced workflows
-- Email support
-- 10GB storage
-- Early access to features
-
-**Enterprise Tier (Custom Pricing)**
-- Unlimited credits
-- Dedicated compute resources
-- Custom neural models
-- 99.9% SLA guarantee
-- Priority 24/7 support
-- Unlimited storage
-- White-label options
-- On-premise deployment
-
-### Cost Optimization Tips
-
-1. **Use Smaller Sandboxes**: Choose appropriate templates (base vs full-stack)
-2. **Optimize Neural Training**: Tune hyperparameters, reduce epochs
-3. **Batch Operations**: Group workflow executions together
-4. **Clean Up Resources**: Delete unused sandboxes and storage
-5. **Monitor Usage**: Check `user_stats` regularly
-6. **Use Free Templates**: Leverage community templates
-7. **Schedule Off-Peak**: Run heavy jobs during low-cost periods
-
----
-
-## Challenges & Achievements
-
-### Browse Challenges
-
-**List Available Challenges**
-```javascript
-mcp__flow-nexus__challenges_list({
-  difficulty: "intermediate", // beginner, intermediate, advanced, expert
-  category: "algorithms",
-  status: "active", // active, completed, locked
-  limit: 20
-})
-```
-
-**Get Challenge Details**
-```javascript
-mcp__flow-nexus__challenge_get({
-  challenge_id: "two-sum-problem"
-})
-```
-
-### Submit Solutions
-
-**Submit Challenge Solution**
-```javascript
-mcp__flow-nexus__challenge_submit({
-  challenge_id: "challenge_id",
-  user_id: "your_user_id",
-  solution_code: `
-    function twoSum(nums, target) {
-      const map = new Map();
-      for (let i = 0; i < nums.length; i++) {
-        const complement = target - nums[i];
-        if (map.has(complement)) {
-          return [map.get(complement), i];
-        }
-        map.set(nums[i], i);
-      }
-      return [];
-    }
-  `,
-  language: "javascript",
-  execution_time: 45 // milliseconds (optional)
-})
-```
-
-**Mark Challenge as Complete**
-```javascript
-mcp__flow-nexus__app_store_complete_challenge({
-  challenge_id: "challenge_id",
-  user_id: "your_user_id",
-  submission_data: {
-    passed_tests: 10,
-    total_tests: 10,
-    execution_time: 45,
-    memory_usage: 2048 // KB
-  }
-})
-```
-
-### Leaderboards
-
-**Global Leaderboard**
-```javascript
-mcp__flow-nexus__leaderboard_get({
-  type: "global", // global, weekly, monthly, challenge
-  limit: 100
-})
-```
-
-**Challenge-Specific Leaderboard**
-```javascript
-mcp__flow-nexus__leaderboard_get({
-  type: "challenge",
-  challenge_id: "specific_challenge_id",
-  limit: 50
-})
-```
-
-### Achievements & Badges
-
-**List User Achievements**
-```javascript
-mcp__flow-nexus__achievements_list({
-  user_id: "your_user_id",
-  category: "speed_demon" // Optional filter
-})
-```
-
-### Challenge Categories
-
-- **algorithms**: Classic algorithm problems (sorting, searching, graphs)
-- **data-structures**: DS implementation (trees, heaps, tries)
-- **system-design**: Architecture and scalability challenges
-- **optimization**: Performance and efficiency problems
-- **security**: Security-focused vulnerabilities and fixes
-- **ml-basics**: Machine learning fundamentals
-- **distributed-systems**: Concurrency and distributed computing
-- **databases**: Query optimization and schema design
-
-### Challenge Difficulty Rewards
-
-- **Beginner**: 10-25 credits
-- **Intermediate**: 50-100 credits
-- **Advanced**: 150-300 credits
-- **Expert**: 400-500 credits
-- **Master**: 600-1000 credits
-
-### Achievement Types
-
-- **Speed Demon**: Complete challenges in record time
-- **Code Golf**: Minimize code length
-- **Perfect Score**: 100% test pass rate
-- **Streak Master**: Complete challenges N days in a row
-- **Polyglot**: Solve in multiple languages
-- **Debugger**: Fix broken code challenges
-- **Optimizer**: Achieve top performance benchmarks
-
-### Tips for Success
-
-1. **Start Simple**: Begin with beginner challenges to build confidence
-2. **Review Solutions**: Study top solutions after completing
-3. **Optimize**: Aim for both correctness and performance
-4. **Daily Practice**: Complete daily challenges for bonus credits
-5. **Community**: Engage with discussions and learn from others
-6. **Track Progress**: Monitor achievements and leaderboard position
-7. **Experiment**: Try multiple approaches to problems
-
----
-
-## Storage & Real-time
-
-### File Storage
-
-**Upload File**
-```javascript
-mcp__flow-nexus__storage_upload({
-  bucket: "my-bucket", // public, private, shared, temp
-  path: "data/users.json",
-  content: JSON.stringify(userData, null, 2),
-  content_type: "application/json"
-})
-```
-
-**List Files**
-```javascript
-mcp__flow-nexus__storage_list({
-  bucket: "my-bucket",
-  path: "data/", // prefix filter
-  limit: 100
-})
-```
-
-**Get Public URL**
-```javascript
-mcp__flow-nexus__storage_get_url({
-  bucket: "my-bucket",
-  path: "data/report.pdf",
-  expires_in: 3600 // seconds (default: 1 hour)
-})
-```
-
-**Delete File**
-```javascript
-mcp__flow-nexus__storage_delete({
-  bucket: "my-bucket",
-  path: "data/old-file.json"
-})
-```
-
-### Storage Buckets
-
-- **public**: Publicly accessible files (CDN-backed)
-- **private**: User-only access with authentication
-- **shared**: Team collaboration with ACL
-- **temp**: Auto-deleted after 24 hours
-
-### Real-time Subscriptions
-
-**Subscribe to Database Changes**
-```javascript
-mcp__flow-nexus__realtime_subscribe({
-  table: "tasks",
-  event: "INSERT", // INSERT, UPDATE, DELETE, *
-  filter: "status=eq.pending AND priority=eq.high"
-})
-```
-
-**List Active Subscriptions**
-```javascript
-mcp__flow-nexus__realtime_list()
-```
-
-**Unsubscribe**
-```javascript
-mcp__flow-nexus__realtime_unsubscribe({
-  subscription_id: "subscription_id"
-})
-```
-
-### Execution Monitoring
-
-**Subscribe to Execution Stream**
-```javascript
-mcp__flow-nexus__execution_stream_subscribe({
-  stream_type: "claude-flow-swarm", // claude-code, claude-flow-swarm, claude-flow-hive-mind, github-integration
-  deployment_id: "deployment_id",
-  sandbox_id: "sandbox_id" // alternative
-})
-```
-
-**Get Stream Status**
-```javascript
-mcp__flow-nexus__execution_stream_status({
-  stream_id: "stream_id"
-})
-```
-
-**List Generated Files**
-```javascript
-mcp__flow-nexus__execution_files_list({
-  stream_id: "stream_id",
-  created_by: "claude-flow", // claude-code, claude-flow, git-clone, user
-  file_type: "javascript" // filter by extension
-})
-```
-
-**Get File Content from Execution**
-```javascript
-mcp__flow-nexus__execution_file_get({
-  file_id: "file_id",
-  file_path: "/path/to/file.js" // alternative
-})
-```
-
----
-
-## System Utilities
-
-### Queen Seraphina AI Assistant
-
-**Seek Guidance from Seraphina**
-```javascript
-mcp__flow-nexus__seraphina_chat({
-  message: "How should I architect a distributed microservices system?",
-  enable_tools: true, // Allow her to create swarms, deploy code, etc.
-  conversation_history: [
-    { role: "user", content: "I need help with system architecture" },
-    { role: "assistant", content: "I can help you design that. What are your requirements?" }
-  ]
-})
-```
-
-Queen Seraphina is an advanced AI assistant with:
-- Deep expertise in distributed systems
-- Ability to create swarms and orchestrate agents
-- Code deployment and architecture design
-- Multi-turn conversation with context retention
-- Tool usage for hands-on assistance
-
-### System Health & Monitoring
-
-**Check System Health**
-```javascript
-mcp__flow-nexus__system_health()
-```
-
-**View Audit Logs**
-```javascript
-mcp__flow-nexus__audit_log({
-  user_id: "your_user_id", // optional filter
-  limit: 100
-})
-```
-
-### Authentication Management
-
-**Initialize Authentication**
-```javascript
-mcp__flow-nexus__auth_init({
-  mode: "user" // user, service
-})
-```
-
----
-
-## Quick Start Guide
-
-### Step 1: Register & Login
-
-```javascript
-// Register
-mcp__flow-nexus__user_register({
-  email: "dev@example.com",
-  password: "SecurePass123!",
-  full_name: "Developer Name"
-})
-
-// Login
-mcp__flow-nexus__user_login({
-  email: "dev@example.com",
-  password: "SecurePass123!"
-})
-
-// Check auth status
-mcp__flow-nexus__auth_status({ detailed: true })
-```
-
-### Step 2: Configure Billing
-
-```javascript
-// Check current balance
-mcp__flow-nexus__check_balance()
-
-// Add credits
-const paymentLink = mcp__flow-nexus__create_payment_link({
-  amount: 50 // $50
-})
-
-// Setup auto-refill
-mcp__flow-nexus__configure_auto_refill({
-  enabled: true,
-  threshold: 100,
-  amount: 50
-})
-```
-
-### Step 3: Create Your First Sandbox
-
-```javascript
-// Create development sandbox
-const sandbox = mcp__flow-nexus__sandbox_create({
-  template: "node",
-  name: "dev-environment",
-  install_packages: ["express", "dotenv"],
-  env_vars: {
-    NODE_ENV: "development"
-  }
-})
-
-// Execute code
-mcp__flow-nexus__sandbox_execute({
-  sandbox_id: sandbox.id,
-  code: 'console.log("Hello Flow Nexus!")',
-  language: "javascript"
-})
-```
-
-### Step 4: Deploy an App
-
-```javascript
-// Browse templates
-mcp__flow-nexus__template_list({
-  category: "backend",
-  featured: true
-})
-
-// Deploy template
-mcp__flow-nexus__template_deploy({
-  template_name: "express-api-starter",
-  deployment_name: "my-api",
-  variables: {
-    database_url: "postgres://..."
-  }
-})
-```
-
-### Step 5: Complete a Challenge
-
-```javascript
-// Find challenges
-mcp__flow-nexus__challenges_list({
-  difficulty: "beginner",
-  category: "algorithms"
-})
-
-// Submit solution
-mcp__flow-nexus__challenge_submit({
-  challenge_id: "fizzbuzz",
-  user_id: "your_id",
-  solution_code: "...",
-  language: "javascript"
-})
-```
-
----
-
-## Best Practices
-
-### Security
-1. Never hardcode API keys - use environment variables
-2. Enable 2FA when available
-3. Regularly rotate passwords and tokens
-4. Use private buckets for sensitive data
-5. Review audit logs periodically
-6. Set appropriate file expiration times
-
-### Performance
-1. Clean up unused sandboxes to save credits
-2. Use smaller sandbox templates when possible
-3. Optimize storage by deleting old files
-4. Batch operations to reduce API calls
-5. Monitor usage via `user_stats`
-6. Use temp buckets for transient data
-
-### Development
-1. Start with sandbox testing before deployment
-2. Version your applications semantically
-3. Document all templates thoroughly
-4. Include tests in published apps
-5. Use execution monitoring for debugging
-6. Leverage real-time subscriptions for live updates
-
-### Cost Management
-1. Set auto-refill thresholds carefully
-2. Monitor credit usage regularly
-3. Complete daily challenges for bonus credits
-4. Publish templates to earn passive credits
-5. Use free-tier resources when appropriate
-6. Schedule heavy jobs during off-peak times
-
----
-
-## Troubleshooting
-
-### Authentication Issues
-- **Login Failed**: Check email/password, verify email first
-- **Token Expired**: Re-login to get fresh tokens
-- **Permission Denied**: Check tier limits, upgrade if needed
-
-### Sandbox Issues
-- **Sandbox Won't Start**: Check template compatibility, verify credits
-- **Execution Timeout**: Increase timeout parameter or optimize code
-- **Out of Memory**: Use larger template or optimize memory usage
-- **Package Install Failed**: Check package name, verify npm/pip availability
-
-### Payment Issues
-- **Payment Failed**: Check payment method, sufficient funds
-- **Credits Not Applied**: Allow 5-10 minutes for processing
-- **Auto-refill Not Working**: Verify payment method on file
-
-### Challenge Issues
-- **Submission Rejected**: Check code syntax, ensure all tests pass
-- **Wrong Answer**: Review test cases, check edge cases
-- **Performance Too Slow**: Optimize algorithm complexity
-
----
-
-## Support & Resources
-
-- **Documentation**: https://docs.flow-nexus.ruv.io
-- **API Reference**: https://api.flow-nexus.ruv.io/docs
-- **Status Page**: https://status.flow-nexus.ruv.io
-- **Community Forum**: https://community.flow-nexus.ruv.io
-- **GitHub Issues**: https://github.com/ruvnet/flow-nexus/issues
-- **Discord**: https://discord.gg/flow-nexus
-- **Email Support**: support@flow-nexus.ruv.io (Pro/Enterprise only)
-
----
-
-## Progressive Disclosure
-
-<details>
-<summary><strong>Advanced Sandbox Configuration</strong></summary>
-
-### Custom Docker Images
-```javascript
-mcp__flow-nexus__sandbox_create({
-  template: "base",
-  name: "custom-environment",
-  startup_script: `
-    apt-get update
-    apt-get install -y custom-package
-    git clone https://github.com/user/repo
-    cd repo && npm install
-  `
-})
-```
-
-### Multi-Stage Execution
-```javascript
-// Stage 1: Setup
-mcp__flow-nexus__sandbox_execute({
-  sandbox_id: "id",
-  code: "npm install && npm run build"
-})
-
-// Stage 2: Run
-mcp__flow-nexus__sandbox_execute({
-  sandbox_id: "id",
-  code: "npm start",
-  working_dir: "/app/dist"
-})
-```
-
-</details>
-
-<details>
-<summary><strong>Advanced Storage Patterns</strong></summary>
-
-### Large File Upload (Chunked)
-```javascript
-const chunkSize = 5 * 1024 * 1024 // 5MB chunks
-for (let i = 0; i < chunks.length; i++) {
-  await mcp__flow-nexus__storage_upload({
-    bucket: "private",
-    path: `large-file.bin.part${i}`,
-    content: chunks[i]
-  })
-}
-```
-
-### Storage Lifecycle
-```javascript
-// Upload to temp for processing
-mcp__flow-nexus__storage_upload({
-  bucket: "temp",
-  path: "processing/data.json",
-  content: data
-})
-
-// Move to permanent storage after processing
-mcp__flow-nexus__storage_upload({
-  bucket: "private",
-  path: "archive/processed-data.json",
-  content: processedData
-})
-```
-
-</details>
-
-<details>
-<summary><strong>Advanced Real-time Patterns</strong></summary>
-
-### Multi-Table Sync
-```javascript
-const tables = ["users", "tasks", "notifications"]
-tables.forEach(table => {
-  mcp__flow-nexus__realtime_subscribe({
-    table,
-    event: "*",
-    filter: `user_id=eq.${userId}`
-  })
-})
-```
-
-### Event-Driven Workflows
-```javascript
-// Subscribe to task completion
-mcp__flow-nexus__realtime_subscribe({
-  table: "tasks",
-  event: "UPDATE",
-  filter: "status=eq.completed"
-})
-
-// Trigger notification workflow on event
-// (handled by your application logic)
-```
-
-</details>
-
----
-
-## Version History
-
-- **v1.0.0** (2025-10-19): Initial comprehensive platform skill
-  - Authentication & user management
-  - Sandbox creation and execution
-  - App store and deployment
-  - Payments and credits
-  - Challenges and achievements
-  - Storage and real-time features
-  - System utilities and Queen Seraphina integration
-
----
-
-*This skill consolidates 6 Flow Nexus command modules into a single comprehensive platform management interface.*