nimbus-expert

name	nimbus_expert
description	Deep expertise in the Nimbus Go framework and its AI integration capabilities.

Nimbus Expert Skill

This skill provides comprehensive knowledge of the Nimbus Go framework, an AdonisJS-style framework for building web applications in Go. It includes details on the framework's architecture, ORM, NoSQL support, plugin system, advanced AI integration, and core utility services.

When to Use

Use this skill when:

• Designing or implementing features in a Nimbus application.
• Troubleshooting issues related to routing, middleware, database, or background services.
• Integrating AI capabilities (Agents, Tools, RAG) using the plugins/ai package.
• Setting up MCP (Model Context Protocol) servers within Nimbus.
• Building custom CLI commands or project generators.
• Writing tests for Nimbus applications.

Knowledge Areas

Core Framework

• Framework Overview: Core architecture and lifecycle.
• Configuration: Layered config and .env loading.
• Routing & Controllers: Route groups, params, resources, controllers.
• Validation: Chainable rules and Form Requests.
• Views & Templates: .nimbus engine, layouts, and components.
• CLI: Scaffolding and generator commands.

Database & Security

• ORM (SQL): GORM-based database management.
• NoSQL: MongoDB and Redis integration.
• Authentication: Auth guards, tokens, and policies.
• CORS & Security: Middleware for security.
• Advanced Features: Health checks, Shield, and Service Container.

Services

• Queue & Jobs: Background job processing.
• Cache: Multi-driver caching and locks.
• Mail: Unified mail API.
• Scheduler: Recurring task management.
• Notification: Multi-channel notifications.
• Search: Full-text search (Meilisearch, Typesense, PostgreSQL).
• WebSocket: WebSocket server and channels.

AI & Integration

• AI SDK: Advanced AI orchestration.
• MCP Integration: Model Context Protocol support.

Plugins

• Plugin System: Extensibility and plugin development.
• Drive: File storage (Local, S3, GCS, R2, Spaces, Supabase).
• Transmit: SSE real-time push.
• Horizon: Queue dashboard.
• Inertia: Vue/React/Svelte SPA adapter.
• Reverb: WebSocket broadcasting.
• Supabase: Supabase services integration.

Development

• Testing: HTTP helpers and AI test generation.
• Best Practices: Development guidelines.

Instructions

1. Always refer to the specific documentation files for detailed information on components.
2. Follow AdonisJS conventions when suggesting code structures.
3. Prioritize the AI SDK for any AI-related tasks.
4. Use CLI Generators for scaffolding boilerplate.
5. Always include tests in your suggested code, leveraging Nimbus testing patterns.