
Generate Terraform HCL code following HashiCorp's official style conventions and best practices. Use when writing, reviewing, or generating Terraform configurations.
Build terminal user interfaces with Go and Bubbletea framework. Use for creating TUI apps with the Elm architecture, dual-pane layouts, accordion modes, mouse/keyboard handling, Lipgloss styling, and reusable components. Includes production-ready templates, effects library, and battle-tested layout patterns from real projects.
Run ClickHouse queries for analytics, metrics analysis, and event data exploration. Use when you need to query ClickHouse directly, analyze metrics, check event tracking data, or test query performance. Read-only by default.
Comprehensive guide to CodeMirror 6. ALWAYS use when writing code that imports from any @codemirror/* package, integrating CodeMirror with SolidJS via solid-codemirror, building command-palette or app-launcher search experiences, implementing LSP-backed completions, or designing autocomplete/tooltip/decoration/panel extensions. Covers CM6 architecture, the full extension API, SolidJS integration (solid-codemirror), LSP integration (@marimo-team/codemirror-languageserver), and real-world patterns from HyperDX's production codebase. Version: CodeMirror 6 only (@codemirror/* ^6.x).
Guides platform architects in managing the software catalog, structuring documentation for Backstage plugins, and maintaining developer portal integrations
Production-tested setup for Content Collections - a TypeScript-first build tool that transforms local content files (Markdown/MDX) into type-safe data collections with automatic validation. Use when: building blogs, documentation sites, or content-heavy applications with Vite + React, setting up MDX content with React components, implementing type-safe content schemas with Zod, migrating from Contentlayer, or encountering TypeScript import errors with content collections. Covers: Vite plugin setup, tsconfig path aliases, collection schemas with Zod validation, MDX compilation with compileMDX, transform functions for computed properties, rehype/remark plugins, React component integration with MDXContent, Cloudflare Workers deployment, and production build optimization. Keywords: content-collections, @content-collections/core, @content-collections/vite, @content-collections/mdx, MDX, markdown, Zod schema validation, type-safe content, frontmatter, compileMDX, defineCollection, defineConfig, Vite plugin, tsconfig paths, .content-collections/generated, MDXContent component, rehype plugins, remark plugins, content schema, document transform, allPosts import, static site generation, blog setup, documentation, Cloudflare Workers static assets, content validation errors, module not found content-collections, path alias not working, MDX type errors, transform function async, collection not updating
Orchestrate the complete OpenSpec workflow — change creation, artifact authoring, worker dispatch, and review — in a single invocation with minimal user intervention.
# Skill: Garden Dev Environment **Description**: Guidance for agents implementing or modifying Garden action configs (`project.garden.yml`, per-service `garden.yml`) for the staccato platform. Covers action types, sync mode, `patchResources`, go.work build context patterns, and the lifecycle split between `task dev-up` and `garden deploy`. **When to use**: When creating or modifying `project.garden.yml`, adding a new service's `garden.yml`, configuring sync mode for a new workload, or troubles
Expert guidance for Go development, including code quality standards, testing practices, service configuration, and HTTP routing patterns.
# Skill: GitHub Actions Patterns **Description**: Guidance for agents implementing GitHub Actions workflow patterns, designing reusable workflows, vetting actions, and managing secrets securely. **When to use**: When implementing GitHub Actions workflows, creating reusable workflow components, selecting actions for CI/CD pipelines, or designing secrets management strategies. --- ## Quick Start ### I'm designing a new workflow 1. Read `.opencode/rules/patterns/workflows/design.md` for the 8
# Skill: Hot-Reload Development **Description**: Guidance for agents configuring development containers with hot-reload capabilities, volume mounts, and watch mechanisms for rapid iteration. **When to use**: When creating development Containerfiles, configuring hot-reload for compiled or interpreted languages, or setting up volume mounts for source code changes. --- ## Quick Start ### I'm setting up hot-reload for a Go service 1. Read `.opencode/rules/patterns/development/hot-reload.md` —
ALWAYS use when writing code importing "gridstack". Consult for debugging, best practices, or modifying gridstack, gridstack.js.
Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.
OpenTelemetry observability patterns: traces, metrics, logs, context propagation, OTLP export, Collector pipelines, and troubleshooting
Fast-forward through OpenSpec artifact creation. Use when the user wants to quickly create all artifacts needed for implementation without stepping through each one individually.
# pnpm-monorepo Manages the pnpm monorepo in `src/dev-portal` using the `vp` (vite-plus) CLI. ## Workspace Structure ``` src/dev-portal/ ├── open-portal/ # Main portal workspace │ ├── apps/ # Applications │ │ ├── web/ # Web application │ │ ├── tui/ # Terminal UI application │ │ ├── web-design-system/ │ │ └── tui-design-system/ │ ├── packages/ # Shared packages │ │ ├── app/ # Core app packag
# S2 Best Practices This skill provides guidance for using and configuring S2, a streaming data platform. ## Overview S2 is a managed streaming data platform that provides real-time data ingestion, processing, and querying capabilities. This skill covers: - S2 CLI usage - Access token management - Basin and stream configuration - Declarative spec files - Integration patterns ## Installation ### CLI Installation ```bash # Install the S2 CLI curl -sSfL https://install.s2.dev | sh # Or use
Compose multiple skills for complex multi-domain tasks. Use when a task requires expertise from more than one skill domain (e.g. a feature that spans Go development, API design, and observability instrumentation).
Track technical debt tasks for the development-orchestrator skill.
Framework-agnostic debouncing, throttling, rate limiting, queuing, and batching utilities for SolidJS.
Full-stack SolidJS framework powered by TanStack Router with SSR, streaming, server functions, and deployment to any hosting provider.
Task management for agents. Use for gaining and sharing information about work to complete.
Expert guidance for building observable, expressive, and fault-tolerant TypeScript applications using the effect-ts/effect ecosystem. Covers Effect<A, E, R> type, error management, dependency injection via Layers, observability (logging, metrics, tracing), concurrency with Fibers, retry/scheduling, Schema validation, Streams, and Sinks.
# Create Worker Agent Skill This skill creates worker agent specifications for the newest free models from opencode and openrouter. ## When to Use This Skill Use this skill when you need to: - Create worker agent specifications for new free AI models - Update existing worker agents when new models become available - Maintain consistency in worker agent specifications across different providers ## Skill Overview This skill creates agent specification files following the pattern `[provider_a
Archive multiple completed changes at once. Use when archiving several parallel changes.
Framework-agnostic, immutable reactive data store with framework adapters for React, Vue, Solid, Angular, and Svelte.
Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.
<!--VITE PLUS START--> # Using Vite+, the Unified Toolchain for the Web This project is using Vite+, a unified toolchain built on top of Vite, Rolldown, Vitest, tsdown, Oxlint, Oxfmt, and Vite Task. Vite+ wraps runtime management, package management, and frontend tooling in a single global CLI called `vp`. Vite+ is distinct from Vite, but it invokes Vite through `vp dev` and `vp build`. ## Vite+ Workflow `vp` is a global binary that handles the full development lifecycle. Run `vp help` to pr
Guide for building performant data tables. Uses tanstack-table for table logic (sorting, filtering, pagination) and tanstack-virtual for rendering large datasets efficiently.
Complete E2E (end-to-end) and integration testing skill for TypeScript/NestJS projects using Jest, real infrastructure via Docker, and GWT pattern. ALWAYS use this skill when user needs to: **SETUP** - Initialize or configure E2E testing infrastructure: - Set up E2E testing for a new project - Configure docker-compose for testing (Kafka, PostgreSQL, MongoDB, Redis) - Create jest-e2e.config.ts or E2E Jest configuration - Set up test helpers for database, Kafka, or Redis - Configure .env.e2e environment variables - Create test/e2e directory structure **WRITE** - Create or add E2E/integration tests: - Write, create, add, or generate e2e tests or integration tests - Test API endpoints, workflows, or complete features end-to-end - Test with real databases, message brokers, or external services - Test Kafka consumers/producers, event-driven workflows - Working on any file ending in .e2e-spec.ts or in test/e2e/ directory - Use GWT (Given-When-Then) pattern for tests **REVIEW** - Audit or evaluate E2E tests: - Review existing E2E tests for quality - Check test isolation and cleanup patterns - Audit GWT pattern compliance - Evaluate assertion quality and specificity - Check for anti-patterns (multiple WHEN actions, conditional assertions) **RUN** - Execute or analyze E2E test results: - Run E2E tests - Start/stop Docker infrastructure for testing - Analyze E2E test results - Verify Docker services are healthy - Interpret test output and failures **DEBUG** - Fix failing or flaky E2E tests: - Fix failing E2E tests - Debug flaky tests or test isolation issues - Troubleshoot connection errors (database, Kafka, Redis) - Fix timeout issues or async operation failures - Diagnose race conditions or state leakage - Debug Kafka message consumption issues **OPTIMIZE** - Improve E2E test performance: - Speed up slow E2E tests - Optimize Docker infrastructure startup - Replace fixed waits with smart polling - Reduce beforeEach cleanup time - Improve test parallelization where safe Keywords: e2e, end-to-end, integration test, e2e-spec.ts, test/e2e, Jest, supertest, NestJS, Kafka, Redpanda, PostgreSQL, MongoDB, Redis, docker-compose, GWT pattern, Given-When-Then, real infrastructure, test isolation, flaky test, MSW, nock, waitForMessages, fix e2e, debug e2e, run e2e, review e2e, optimize e2e, setup e2e
Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications. Use when implementing complex type logic, creating reusable type utilities, or ensuring compile-time type safety in TypeScript projects.
Write integration tests using TestContainers for TypeScript with Vitest. Covers infrastructure testing with real databases, caches, and message queues in Docker containers instead of mocks.
Audit the codebase and catalog for undocumented technologies, patterns, libraries, CLI tools, and components. Surfaces gaps where a tool/language/framework/library/pattern is in use but has no corresponding OpenSpec change, ADR, usage rule, or catalog entity.
Headless UI for virtualizing large element lists at 60FPS in TS/JS, React, Vue, Solid, Svelte, Lit & Angular. Includes SolidJS examples using @tanstack/solid-virtual.
Headless UI for building powerful tables & datagrids for TS/JS, React, Vue, Solid, Svelte, Qwik, Angular, and Lit.
TanStack Start best practices for full-stack Solid applications. Server functions, middleware, SSR, authentication, and deployment patterns. Activate when building full-stack apps with TanStack Start.
TanStack Router best practices for type-safe routing, data loading, search params, and navigation. Activate when building Solid applications with complex routing needs.
Powerful asynchronous state management, server-state utilities, and data fetching for SolidJS, TS/JS.
TanStack Hotkeys for type-safe keyboard shortcuts with React hooks. Use when adding keyboard shortcuts, hotkey sequences, shortcut recording, key hold detection, or platform-aware shortcut display. Use for hotkeys, keyboard-shortcuts, shortcuts, key-binding, Mod key, hotkey-recorder, key-sequences.
Headless, performant, and type-safe form state management for TS/JS, React, Vue, Angular, Solid, Lit, and Svelte.
Patterns for extracting and processing structured data from CLI tools. Use jq for JSON, yq for YAML, and md-tree for Markdown. Apply these patterns instead of manual parsing to reduce token usage and improve clarity.
Solid.js best practices for AI-assisted code generation, code review, refactoring, and debugging reactivity issues. Use when writing Solid.js components, auditing SolidJS code, migrating from React to Solid, fixing signals and fine-grained reactivity bugs, or integrating web component libraries. 55 rules across 8 categories (reactivity, components, control flow, state management, refs/DOM, performance, accessibility, testing) ranked by priority.
Extract and return the content of a markdown file given its link. Used when provided a .md#link
Use when adding or modifying Paraglide JS internationalization, locale detection strategies, localized routing, or generated message usage in Vite, SSR, TanStack Start, or monorepo setups.
Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
Start a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature, fix, or modification with a structured step-by-step approach.
Continue working on an OpenSpec change by creating the next artifact. Use when the user wants to progress their change, create the next artifact, or continue their workflow.
# Skill: open-portal ## When to Use This Skill Use this skill when: - Writing code that imports from `@op/platform` or `@op-plugin/*` - Implementing new plugins for the open-portal platform - Writing integration tests that instantiate the platform - Debugging plugin lifecycle issues (preStart, onInit, onReady, onDestroy) - Understanding how the OpenPort platform is bootstrapped and configured - Configuring DI services via the ServiceRegistry - Adding plugin configuration schemas Keywords: op
Guide worker agents on implementing OpenTelemetry instrumentation, metrics, structured logging, and cross-signal correlation for Go services
Expert guide for building Nitro server applications. Use when implementing Nitro handlers, configuring presets, setting up routing, working with middleware, tasks, storage, database, WebSocket, or deploying to any supported platform (Cloudflare, Deno, Node.js, Netlify, Zephyr, AWS Amplify, etc.). Covers filesystem routing, route rules, code splitting, presets, hooks, and runtime behavior.
Find and fix broken links in documentation and code using lychee. Scan files with --format json to identify broken URLs, then systematically repair or update them.
Headless browser automation using Playwright CLI. Use when you need headless browsing, parallel browser sessions, UI testing, screenshots, web scraping, or browser automation that can run in the background. Keywords - playwright, headless, browser, test, screenshot, scrape, parallel.
Go testing patterns including table-driven tests, subtests, benchmarks, fuzzing, and test coverage. Follows TDD methodology with idiomatic Go practices.
Implements concurrent Go patterns using goroutines and channels, designs and builds microservices with gRPC or REST, optimizes Go application performance with pprof, and enforces idiomatic Go with generics, interfaces, and robust error handling. Use when building Go applications requiring concurrent programming, microservices architecture, or high-performance systems. Invoke for goroutines, channels, Go generics, gRPC integration, CLI tools, benchmarks, or table-driven testing.
Type-safe hybrid RBAC + ABAC access control engine for TypeScript using @gentleduck/iam. Use when implementing authorization, permissions, roles, policies, access control, multi-tenant scoped roles, or attribute-based conditions in TypeScript applications. ALWAYS use this skill when writing code that imports from "@gentleduck/iam" or "duck-iam", when designing permission schemas, defining roles with inheritance, building ABAC policies with condition builders, configuring the evaluation engine, or debugging authorization decisions. Also use when the user asks about RBAC vs ABAC hybrid approaches, policy combining algorithms, owner-only access patterns, or defense-in-depth authorization layers.
Learn how to create a Lit web component with CodeMirror, dynamically themed using Material Design's color utilities, for a customizable code editing experience.
DigitalOcean management services for monitoring, uptime checks, and resource organization with Projects. Use when setting up observability, alerts, and operational visibility on DigitalOcean.
DigitalOcean containers and images including Container Registry, preconfigured images, and custom images. Use when building, storing, or deploying container images or Droplet images on DigitalOcean.
Guide for managing and maintaining dagger CI/CD tooling in this repository. Use when adding, modifying, or running dagger tasks.
# Skill: Containerization Patterns **Description**: Guidance for agents implementing multi-stage Containerfiles with separate production and development configurations, base image selection, and container optimization. **When to use**: When creating Containerfiles for deployable artifacts, implementing multi-stage builds, selecting base images, or configuring development containers with hot-reload. --- ## Quick Start ### I'm creating a production Containerfile for a Go service 1. Read `.ope
Expert guidance for designing and implementing CLI tools. Use command structure modeled after kubectl for consistency and familiarity.
MUST USE when reviewing ClickHouse schemas, queries, or configurations. Contains 28 rules that MUST be checked before providing recommendations. Always read relevant rule files and cite specific rules in responses.
Best practices and patterns for using Better Auth authentication library. Use when implementing authentication features, configuring Better Auth initialization, managing users and organizations, setting up OAuth providers, handling sessions, or integrating Better Auth with TypeScript applications. ALWAYS use when writing code that imports from "better-auth" or "@op-plugin/authentication-better-auth", when designing authentication flows, configuring database schemas, setting up plugins, or handling session management. Also use for OAuth integration, email verification patterns, password reset flows, organization management, and role-based access.
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
Continuous background audit loop. Runs incremental audits every 10 minutes (when git changes are detected) and a comprehensive full audit every hour. Emits a heartbeat to a shared state file so the development-orchestrator can detect and restart a dead auditor.
Research skills for tasks
Use when deploying or managing Kubernetes workloads. Invoke to create deployment manifests, configure pod security policies, set up service accounts, define network isolation rules, debug pod crashes, analyze resource limits, inspect container logs, or right-size workloads. Use for Helm charts, RBAC policies, NetworkPolicies, storage configuration, performance optimization, GitOps pipelines, and multi-cluster management.
Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: "design a UI", "create interface", "build layout", "design dashboard", "create form", "design landing page", "make it accessible", "design system", "component library".
Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.
Discover existing cloud resources using Terraform Search queries and bulk import them into Terraform management. Use when bringing unmanaged infrastructure under Terraform control, auditing cloud resources, or migrating to IaC.