@iamnishankhan/opencode-kit-grok 1.0.0

package/kit/.opencode/skills/app-builder/templates/astro-static/TEMPLATE.md

@@ -0,0 +1,78 @@
+---
+name: astro-static
+description: Astro static site template principles. Content-focused websites, blogs, documentation.
+---
+
+# Astro Static Site Template
+
+> Versions reflect the latest stable line verified 2026-05. Pin to the current stable when scaffolding.
+
+## Tech Stack
+
+| Component | Technology |
+|-----------|------------|
+| Framework | Astro 6.x |
+| Content | MDX + Content Collections (Content Layer API) |
+| Styling | Tailwind CSS v4 (@tailwindcss/vite) |
+| Integrations | Sitemap, RSS, SEO |
+| Output | Static/SSG |
+
+---
+
+## Directory Structure
+
+```
+project-name/
+├── src/
+│   ├── components/      # .astro components
+│   ├── content/         # Collection entries (blog/, docs/ .md/.mdx)
+│   ├── layouts/         # Page layouts
+│   ├── pages/           # File-based routing (only reserved dir)
+│   ├── styles/
+│   │   └── global.css   # @import "tailwindcss";
+│   └── content.config.ts # Collection definitions (Content Layer, in src/ root)
+├── public/              # Static assets
+├── astro.config.mjs
+└── package.json
+```
+
+---
+
+## Key Concepts
+
+| Concept | Description |
+|---------|-------------|
+| Content Layer API | Collections defined in `src/content.config.ts` with `loader`s (glob/file) + Zod schemas |
+| Islands Architecture | Partial hydration for interactivity |
+| Zero JS by default | Static HTML unless needed |
+| MDX Support | Markdown with components |
+
+---
+
+## Setup Steps
+
+1. `npm create astro@latest {{name}}`
+2. Add integrations: `npx astro add mdx sitemap`
+3. Add Tailwind v4: `npx astro add tailwind` (installs @tailwindcss/vite, not the legacy @astrojs/tailwind)
+4. Define collections in `src/content.config.ts` using `loader`s + Zod schemas
+5. `npm run dev`
+
+---
+
+## Deployment
+
+| Platform | Method |
+|----------|--------|
+| Vercel | Auto-detected |
+| Netlify | Auto-detected |
+| Cloudflare Pages | Auto-detected |
+| GitHub Pages | Build + deploy action |
+
+---
+
+## Best Practices
+
+- Use Content Collections for type safety
+- Leverage static generation
+- Add islands only where needed
+- Optimize images with Astro Image

package/kit/.opencode/skills/app-builder/templates/chrome-extension/TEMPLATE.md

@@ -0,0 +1,96 @@
+---
+name: chrome-extension
+description: Chrome Extension template principles. Manifest V3, React, TypeScript.
+---
+
+# Chrome Extension Template
+
+> Versions reflect the latest stable line verified 2026-05. Pin to the current stable when scaffolding.
+
+## Tech Stack
+
+| Component | Technology |
+|-----------|------------|
+| Manifest | V3 |
+| UI | React 19 |
+| Language | TypeScript |
+| Styling | Tailwind CSS v4 |
+| Bundler | Vite + CRXJS (@crxjs/vite-plugin v2) |
+| Storage | Chrome Storage API |
+
+---
+
+## Directory Structure
+
+> CRXJS + Vite: `manifest.config.ts` is the source of truth, Vite resolves entries.
+
+```
+project-name/
+├── src/
+│   ├── popup/           # { index.html, main.tsx, Popup.tsx }
+│   ├── options/         # { index.html, main.tsx, Options.tsx }
+│   ├── background/      # service-worker.ts (MV3 service worker)
+│   ├── content/         # { content-script.ts, content.css }
+│   ├── components/      # Shared React
+│   └── lib/
+│       ├── storage.ts   # Chrome storage helpers
+│       └── messaging.ts # Message passing
+├── public/              # Static assets (icons)
+├── manifest.config.ts   # defineManifest() — typed manifest
+├── vite.config.ts       # crx({ manifest }) + react + tailwind
+└── package.json
+```
+
+---
+
+## Manifest V3 Concepts
+
+| Component | Purpose |
+|-----------|---------|
+| Service Worker | Background processing |
+| Content Scripts | Page injection |
+| Popup | User interface |
+| Options Page | Settings |
+
+---
+
+## Permissions
+
+| Permission | Use |
+|------------|-----|
+| storage | Save user data |
+| activeTab | Current tab access |
+| scripting | Inject scripts |
+| host_permissions | Site access |
+
+---
+
+## Setup Steps
+
+1. `npm create vite@latest {{name}} -- --template react-ts`
+2. Install CRXJS: `npm install -D @crxjs/vite-plugin@latest`
+3. Add Chrome types: `npm install -D @types/chrome`
+4. Create `manifest.config.ts` with `defineManifest`, wire `crx({ manifest })` in `vite.config.ts`
+5. `npm run dev` (HMR for popup/options/content)
+6. Load in Chrome: `chrome://extensions` → Load unpacked → select `dist/`
+
+---
+
+## Development Tips
+
+| Task | Method |
+|------|--------|
+| Debug Popup | Right-click icon → Inspect |
+| Debug Background | Extensions page → Service worker |
+| Debug Content | DevTools console on page |
+| Hot Reload | `npm run dev` (CRXJS HMR) |
+
+---
+
+## Best Practices
+
+- Use type-safe messaging
+- Wrap Chrome APIs in promises
+- MV3 background is an ephemeral service worker — persist state in `chrome.storage`, not module globals; use event listeners + alarms, not long-lived timers
+- Minimize permissions
+- Scope content-script styles to avoid host-page bleed

package/kit/.opencode/skills/app-builder/templates/cli-tool/TEMPLATE.md

@@ -0,0 +1,88 @@
+---
+name: cli-tool
+description: Node.js CLI tool template principles. Commander.js, interactive prompts.
+---
+
+# CLI Tool Template
+
+> Versions reflect the latest stable line verified 2026-05. Pin to the current stable when scaffolding.
+
+## Tech Stack
+
+| Component | Technology |
+|-----------|------------|
+| Runtime | Node.js 24 (Krypton LTS) |
+| Language | TypeScript (ESM) |
+| CLI Framework | Commander.js (v15, needs Node ≥22.12) |
+| Prompts | @inquirer/prompts (modular) |
+| Output | chalk + ora |
+| Config | cosmiconfig |
+
+---
+
+## Directory Structure
+
+```
+project-name/
+├── src/
+│   ├── index.ts         # Entry: #!/usr/bin/env node shebang, wires Commander
+│   ├── commands/        # One file per command (factory functions)
+│   ├── lib/             # Core logic (framework-agnostic, testable)
+│   ├── utils/           # logger (chalk/ora), prompt wrappers
+│   └── config.ts        # cosmiconfig loader
+├── dist/                # Build output (tsup/tsc)
+└── package.json         # "type":"module", "bin":{...}
+```
+
+---
+
+## CLI Design Principles
+
+| Principle | Description |
+|-----------|-------------|
+| Subcommands | Group related actions |
+| Options | Flags with defaults |
+| Interactive | Prompts when needed |
+| Non-interactive | Support --yes flags |
+
+---
+
+## Key Components
+
+| Component | Purpose |
+|-----------|---------|
+| Commander | Command parsing (use a local `new Command()` for testability) |
+| @inquirer/prompts | Modular interactive prompts (`input`, `select`, `confirm`) |
+| Chalk | Colored output |
+| Ora | Spinners/loading |
+| Cosmiconfig | Config file discovery |
+
+---
+
+## Setup Steps
+
+1. Create project directory
+2. `npm init -y` then set `"type": "module"`
+3. Install deps: `npm install commander @inquirer/prompts chalk ora cosmiconfig`
+4. Point `bin` at compiled `./dist/index.js`, keep `#!/usr/bin/env node` shebang
+5. `npm link` for local testing
+
+---
+
+## Publishing
+
+```bash
+npm login
+npm publish
+```
+
+---
+
+## Best Practices
+
+- Keep `src/index.ts` thin; attach commands via `.addCommand()` factories in `src/commands/`
+- Put business logic in `lib/`/`utils/` so commands stay testable wrappers
+- ESM by default; build with tsup/esbuild
+- Support both interactive and non-interactive (`--yes`) modes
+- Validate inputs with Zod; exit with proper codes (0 success, 1 error)
+- Alternatives worth knowing: @clack/prompts (polished prompts), citty (lightweight ESM command framework)

package/kit/.opencode/skills/app-builder/templates/electron-desktop/TEMPLATE.md

@@ -0,0 +1,97 @@
+---
+name: electron-desktop
+description: Electron desktop app template principles. Cross-platform, React, TypeScript.
+---
+
+# Electron Desktop App Template
+
+> Versions reflect the latest stable line verified 2026-05. Pin to the current stable when scaffolding.
+
+## Tech Stack
+
+| Component | Technology |
+|-----------|------------|
+| Framework | Electron 42+ |
+| UI | React 19 |
+| Language | TypeScript |
+| Styling | Tailwind CSS v4 |
+| Bundler | electron-vite + electron-builder |
+| IPC | Type-safe communication (contextBridge) |
+
+---
+
+## Directory Structure
+
+> electron-vite layout: main / preload / renderer separation is the 2026 standard.
+
+```
+project-name/
+├── src/
+│   ├── main/            # Main process (lifecycle, windows, IPC handlers)
+│   │   └── index.ts
+│   ├── preload/         # contextBridge — type-safe IPC surface
+│   │   ├── index.ts
+│   │   └── index.d.ts   # Ambient types shared with renderer
+│   └── renderer/        # React app
+│       ├── index.html
+│       └── src/
+│           ├── main.tsx
+│           ├── App.tsx
+│           └── components/
+├── resources/           # App icons / static (build-time)
+├── build/               # Builder assets (entitlements, icons)
+├── electron.vite.config.ts
+├── electron-builder.yml
+└── package.json         # scripts: electron-vite dev | build | preview
+```
+
+---
+
+## Process Model
+
+| Process | Role |
+|---------|------|
+| Main | Node.js, system access |
+| Renderer | Chromium, React UI |
+| Preload | Bridge, context isolation |
+
+---
+
+## Key Concepts
+
+| Concept | Purpose |
+|---------|---------|
+| contextBridge | Safe API exposure |
+| ipcMain/ipcRenderer | Process communication |
+| nodeIntegration: false | Security |
+| contextIsolation: true | Security |
+
+---
+
+## Setup Steps
+
+1. `npm create @quick-start/electron@latest {{name}} -- --template react-ts`
+2. `cd {{name}} && npm install`
+3. Add Tailwind v4: `npm install tailwindcss @tailwindcss/vite`
+4. Define IPC types in `src/preload/index.d.ts`
+5. `npm run dev`
+
+---
+
+## Build Targets
+
+| Platform | Output |
+|----------|--------|
+| Windows | NSIS, Portable |
+| macOS | DMG, ZIP |
+| Linux | AppImage, DEB |
+
+---
+
+## Best Practices
+
+- `contextIsolation: true` (default v12+), `sandbox: true` (default v20+), `nodeIntegration: false` (default v5+) — never enable Node for remote content
+- Expose a narrow API via `contextBridge.exposeInMainWorld`, never raw `ipcRenderer`
+- Validate IPC `sender` against an allowlist; set a restrictive CSP (`script-src 'self'`)
+- Type-safe IPC: share types from `preload/index.d.ts` into the renderer
+- Auto-updates with electron-updater

package/kit/.opencode/skills/app-builder/templates/express-api/TEMPLATE.md

@@ -0,0 +1,89 @@
+---
+name: express-api
+description: Express.js REST API template principles. TypeScript, Prisma, JWT.
+---
+
+# Express.js API Template
+
+> Versions reflect the latest stable line verified 2026-05. Pin to the current stable when scaffolding.
+
+## Tech Stack
+
+| Component | Technology |
+|-----------|------------|
+| Runtime | Node.js 24 (Krypton LTS) |
+| Framework | Express 5 (stable, default on npm) |
+| Language | TypeScript |
+| Database | PostgreSQL + Prisma |
+| Validation | Zod |
+| Auth | JWT + bcrypt |
+
+---
+
+## Directory Structure
+
+```
+project-name/
+├── prisma/
+│   └── schema.prisma
+├── src/
+│   ├── app.ts           # Express app + middleware wiring (no listen)
+│   ├── server.ts        # Bootstrap: listen() — split for testability
+│   ├── config/          # Environment
+│   ├── routes/          # Route definitions only
+│   ├── controllers/     # HTTP layer (req/res, calls services)
+│   ├── services/        # Business logic
+│   ├── middlewares/
+│   │   ├── auth.ts      # JWT verify
+│   │   ├── error.ts     # Error handler
+│   │   └── validate.ts  # Zod validation
+│   ├── schemas/         # Zod schemas
+│   └── utils/
+├── tests/
+└── package.json
+```
+
+---
+
+## Middleware Stack
+
+| Order | Middleware |
+|-------|------------|
+| 1 | helmet (security) |
+| 2 | cors |
+| 3 | compression |
+| 4 | body parsing |
+| 5 | morgan (logging) |
+| 6 | routes |
+| 7 | error handler (last, 4-arg signature) |
+
+---
+
+## API Response Format
+
+| Type | Structure |
+|------|-----------|
+| Success | `{ success: true, data: {...} }` |
+| Error | `{ error: "message", details: [...] }` |
+
+---
+
+## Setup Steps
+
+1. Create project directory
+2. `npm init -y`
+3. Install deps: `npm install express prisma zod bcrypt jsonwebtoken`
+4. Configure Prisma
+5. `npm run db:push`
+6. `npm run dev`
+
+---
+
+## Best Practices
+
+- Split `app.ts` (wiring) from `server.ts` (`listen`) so the app imports cleanly into tests
+- Layer architecture (routes → controllers → services)
+- Validate all inputs with Zod at the route boundary
+- Centralized error handler last (Express 5 auto-forwards rejected promises — no manual catch wrapper needed)
+- Environment-based config
+- Use Prisma for type-safe DB access

package/kit/.opencode/skills/app-builder/templates/flutter-app/TEMPLATE.md

@@ -0,0 +1,93 @@
+---
+name: flutter-app
+description: Flutter mobile app template principles. Riverpod, Go Router, clean architecture.
+---
+
+# Flutter App Template
+
+> Versions reflect the latest stable line verified 2026-05. Pin to the current stable when scaffolding.
+
+## Tech Stack
+
+| Component | Technology |
+|-----------|------------|
+| Framework | Flutter 3.x |
+| Language | Dart 3.x |
+| State | Riverpod 3 (codegen) |
+| Navigation | Go Router |
+| HTTP | Dio |
+| Storage | Hive |
+
+---
+
+## Directory Structure
+
+```
+project_name/
+├── lib/
+│   ├── main.dart
+│   ├── app.dart
+│   ├── core/
+│   │   ├── constants/
+│   │   ├── theme/
+│   │   ├── router/
+│   │   └── utils/
+│   ├── features/
+│   │   ├── auth/
+│   │   │   ├── data/
+│   │   │   ├── domain/
+│   │   │   └── presentation/
+│   │   └── home/
+│   ├── shared/
+│   │   ├── widgets/
+│   │   └── providers/
+│   └── services/
+│       ├── api/
+│       └── storage/
+├── test/
+└── pubspec.yaml
+```
+
+---
+
+## Architecture Layers
+
+| Layer | Contents |
+|-------|----------|
+| Presentation | Screens, Widgets, Providers |
+| Domain | Entities, Use Cases |
+| Data | Repositories, Models |
+
+---
+
+## Key Packages
+
+| Package | Purpose |
+|---------|---------|
+| flutter_riverpod | State management |
+| riverpod_annotation | Code generation |
+| go_router | Navigation |
+| dio | HTTP client |
+| freezed | Immutable models |
+| hive | Local storage |
+
+---
+
+## Setup Steps
+
+1. `flutter create {{name}} --org com.{{bundle}}`
+2. Update `pubspec.yaml`
+3. `flutter pub get`
+4. Run code generation: `dart run build_runner build`
+5. `flutter run`
+
+---
+
+## Best Practices
+
+- Feature-first folder structure (data / domain / presentation per feature)
+- Riverpod 3 with `riverpod_annotation` codegen (generated ref is just `Ref`; plain `Notifier`, no `AutoDisposeNotifier`)
+- Legacy `StateProvider`/`StateNotifierProvider` moved to `package:riverpod/legacy.dart`
+- Freezed for immutable data classes
+- Go Router for declarative navigation
+- Material 3 theming

package/kit/.opencode/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md

@@ -0,0 +1,97 @@
+---
+name: monorepo-turborepo
+description: Turborepo monorepo template principles. pnpm workspaces, shared packages.
+---
+
+# Turborepo Monorepo Template
+
+> Versions reflect the latest stable line verified 2026-05. Pin to the current stable when scaffolding.
+
+## Tech Stack
+
+| Component | Technology |
+|-----------|------------|
+| Build System | Turborepo 2.x |
+| Package Manager | pnpm |
+| Apps | Next.js, Express |
+| Packages | Shared UI, Config, Types, Utils |
+| Language | TypeScript |
+
+---
+
+## Directory Structure
+
+```
+project-name/
+├── apps/
+│   ├── web/             # Next.js app
+│   ├── api/             # Express API
+│   └── docs/            # Documentation
+├── packages/
+│   ├── ui/              # Shared components (@repo/ui)
+│   ├── config/          # ESLint, TS, Tailwind presets (@repo/config)
+│   ├── types/           # Shared types (@repo/types)
+│   └── utils/           # Shared utilities (@repo/utils)
+├── turbo.json           # "tasks" key (renamed from "pipeline" in v2)
+├── pnpm-workspace.yaml
+└── package.json         # requires "packageManager" field
+```
+
+---
+
+## Key Concepts
+
+| Concept | Description |
+|---------|-------------|
+| Workspaces | Globs declared in `pnpm-workspace.yaml` |
+| Pipeline | `turbo.json` `tasks` graph (NOT `pipeline` — renamed in v2) |
+| Caching | Remote/local task caching |
+| Dependencies | `workspace:*` protocol, `@repo/*` namespace |
+| Env mode | v2 is strict — declare task `env`/`globalEnv` or caching breaks |
+
+---
+
+## Turbo Tasks (turbo.json)
+
+> `tasks` is the v2 key. The `pipeline` key was renamed — migrate with `npx @turbo/codemod rename-pipeline`.
+
+| Task | Depends On |
+|------|------------|
+| build | ^build (dependencies first) |
+| dev | cache: false, persistent |
+| lint | ^build |
+| test | ^build |
+
+---
+
+## Setup Steps
+
+1. Create root directory
+2. `pnpm init`
+3. Create pnpm-workspace.yaml
+4. Create turbo.json
+5. Add apps and packages
+6. `pnpm install`
+7. `pnpm dev`
+
+---
+
+## Common Commands
+
+| Command | Description |
+|---------|-------------|
+| `pnpm dev` | Run all apps |
+| `pnpm build` | Build all |
+| `pnpm --filter @name/web dev` | Run specific app |
+| `pnpm --filter @name/web add axios` | Add dep to app |
+
+---
+
+## Best Practices
+
+- Split `apps/` (deployable) from `packages/` (libraries, shared config)
+- Namespace internal packages with `@repo/*`; reference via `workspace:*`
+- Define entrypoints with the `exports` field (better tree-shaking than barrel files)
+- Share tsconfig/eslint from `packages/config`
+- Declare task `env`/`globalEnv` explicitly (v2 strict env mode)
+- Use Turbo remote caching for CI