@1aboveio/skills 0.0.0-stage → 1.0.0

package/skills/app-dev/monorepo/SKILL.md

@@ -0,0 +1,462 @@
+---
+name: monorepo
+description: Turborepo architecture for shared packages, pnpm workspaces, DAL boundaries, and pipelines.
+release-version: 0.36.0
+---
+**Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
+# Turborepo Monorepo Architecture
+
+**Turborepo** | **pnpm workspaces** | **Next.js 16** | **Prisma** | **Shadcn UI**
+
+## Core Technology Stack
+
+- **Manager:** Turborepo
+- **Package Manager:** pnpm
+- **Framework:** Next.js 16 (App Router)
+- **Language:** TypeScript (Strict Mode)
+- **UI System:** Shadcn UI (Radix + Tailwind)
+- **Database:** Prisma (PostgreSQL)
+- **Architecture:** DAL Separation
+
+---
+
+## Directory Structure
+
+```
+repo/
+├── apps/
+│   └── web/                    # Next.js application
+├── packages/
+│   ├── typescript-config/      # Shared TS configs
+│   ├── eslint-config/          # Shared ESLint configs
+│   ├── database/               # Raw Prisma schema + client
+│   ├── dal/                    # Data Access Layer
+│   └── ui/                     # Shadcn UI system
+├── turbo.json
+├── pnpm-workspace.yaml
+└── package.json
+```
+
+---
+
+## Root Configuration
+
+### pnpm-workspace.yaml
+
+```yaml
+packages:
+  - "apps/*"
+  - "packages/*"
+```
+
+### turbo.json
+
+```json
+{
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"]
+    },
+    "dev": {
+      "dependsOn": ["^db:generate"],
+      "cache": false,
+      "persistent": true
+    },
+    "db:generate": {
+      "inputs": ["schema.prisma"]
+    },
+    "lint": {}
+  }
+}
+```
+
+---
+
+## Package: typescript-config
+
+Shared TypeScript configurations.
+
+```
+packages/typescript-config/
+├── base.json
+├── nextjs.json
+└── server.json
+```
+
+### base.json
+
+```json
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true
+  }
+}
+```
+
+### nextjs.json
+
+```json
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "jsx": "preserve",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "module": "esnext",
+    "target": "esnext",
+    "plugins": [{ "name": "next" }]
+  }
+}
+```
+
+### server.json
+
+```json
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "lib": ["esnext"],
+    "module": "esnext",
+    "target": "esnext"
+  }
+}
+```
+
+---
+
+## Package: database
+
+Holds **only** the Prisma schema and raw client. No business logic.
+
+```
+packages/database/
+├── prisma/
+│   └── schema.prisma
+├── client.ts
+├── package.json
+└── index.ts
+```
+
+### schema.prisma
+
+```prisma
+generator client {
+  provider = "prisma-client"
+  output   = "../generated/prisma"
+}
+
+datasource db {
+  provider = "postgresql"
+}
+
+model User {
+  id        String   @id @default(cuid())
+  email     String   @unique
+  name      String?
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}
+```
+
+### client.ts
+
+```typescript
+import { PrismaClient } from "./generated/prisma/client"
+import { PrismaPg } from "@prisma/adapter-pg"
+
+const adapter = new PrismaPg({
+  connectionString: process.env.DATABASE_URL!,
+})
+
+const globalForPrisma = globalThis as unknown as { database?: PrismaClient }
+
+export const database =
+  globalForPrisma.database ?? new PrismaClient({ adapter })
+
+if (process.env.NODE_ENV !== "production") {
+  globalForPrisma.database = database
+}
+```
+
+### index.ts
+
+```typescript
+export * from "./generated/prisma"
+export { database } from "./client"
+```
+
+### package.json
+
+```json
+{
+  "name": "@repo/database",
+  "private": true,
+  "main": "index.ts",
+  "scripts": {
+    "db:generate": "prisma generate",
+    "db:push": "prisma db push"
+  }
+}
+```
+
+---
+
+## Package: dal (Data Access Layer)
+
+The **only** package allowed to import `@repo/database`.
+
+```
+packages/dal/
+├── src/
+│   ├── users/
+│   │   ├── queries.ts
+│   │   └── mutations.ts
+│   └── index.ts
+└── package.json
+```
+
+### Requirements
+
+- **Server-Only:** All files must start with `import 'server-only'`
+- **DTOs:** Return plain objects, not class instances
+- **Dependencies:** `@repo/database`, `server-only`
+
+### src/users/queries.ts
+
+```typescript
+import "server-only"
+import { database } from "@repo/database"
+
+export async function getUsers() {
+  return database.user.findMany({
+    orderBy: { createdAt: "desc" },
+  })
+}
+
+export async function getUserById(id: string) {
+  return database.user.findUnique({
+    where: { id },
+  })
+}
+```
+
+### src/users/mutations.ts
+
+```typescript
+import "server-only"
+import { database } from "@repo/database"
+
+export async function createUser(data: { email: string; name?: string }) {
+  return database.user.create({ data })
+}
+
+export async function updateUser(id: string, data: { name?: string }) {
+  return database.user.update({
+    where: { id },
+    data,
+  })
+}
+```
+
+### src/index.ts
+
+```typescript
+export * from "./users/queries"
+export * from "./users/mutations"
+```
+
+### package.json
+
+```json
+{
+  "name": "@repo/dal",
+  "private": true,
+  "main": "src/index.ts",
+  "dependencies": {
+    "@repo/database": "*",
+    "server-only": "*"
+  }
+}
+```
+
+---
+
+## Package: ui (Shadcn)
+
+Centralized, exportable UI library.
+
+```
+packages/ui/
+├── src/
+│   ├── components/
+│   │   └── ui/
+│   │       ├── button.tsx
+│   │       └── input.tsx
+│   └── styles/
+│       └── globals.css
+├── components.json
+├── tailwind.config.ts
+├── index.ts
+└── package.json
+```
+
+### tailwind.config.ts (Master Config)
+
+```typescript
+import type { Config } from "tailwindcss"
+
+const config: Config = {
+  darkMode: ["class"],
+  content: ["./src/**/*.{ts,tsx}"],
+  theme: {
+    extend: {
+      colors: {
+        border: "hsl(var(--border))",
+        background: "hsl(var(--background))",
+        foreground: "hsl(var(--foreground))",
+        primary: {
+          DEFAULT: "hsl(var(--primary))",
+          foreground: "hsl(var(--primary-foreground))",
+        },
+      },
+      borderRadius: {
+        lg: "var(--radius)",
+        md: "calc(var(--radius) - 2px)",
+        sm: "calc(var(--radius) - 4px)",
+      },
+    },
+  },
+  plugins: [require("tailwindcss-animate")],
+}
+
+export default config
+```
+
+### index.ts
+
+```typescript
+export * from "./src/components/ui/button"
+export * from "./src/components/ui/input"
+// Export tailwind config for apps to preset
+```
+
+---
+
+## App: apps/web
+
+### Dependencies
+
+```json
+{
+  "dependencies": {
+    "@repo/ui": "*",
+    "@repo/dal": "*"
+  }
+}
+```
+
+**FORBIDDEN:** Do not import `@repo/database` directly.
+
+### next.config.ts
+
+```typescript
+import type { NextConfig } from "next"
+
+const config: NextConfig = {
+  transpilePackages: ["@repo/ui", "@repo/dal"],
+}
+
+export default config
+```
+
+### tailwind.config.ts
+
+```typescript
+import type { Config } from "tailwindcss"
+import sharedConfig from "@repo/ui/tailwind.config"
+
+const config: Config = {
+  presets: [sharedConfig],
+  content: [
+    "./app/**/*.{ts,tsx}",
+    "../../packages/ui/src/**/*.{ts,tsx}",
+  ],
+}
+
+export default config
+```
+
+### Root Layout
+
+```typescript
+import "@repo/ui/src/styles/globals.css"
+
+export default function RootLayout({ children }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}
+```
+
+### Page Example
+
+```typescript
+// app/page.tsx
+import { getUsers } from "@repo/dal"
+import { Button } from "@repo/ui"
+
+export default async function HomePage() {
+  const users = await getUsers()
+
+  return (
+    <main>
+      <h1>Users</h1>
+      <ul>
+        {users.map((user) => (
+          <li key={user.id}>{user.name}</li>
+        ))}
+      </ul>
+      <Button>Add User</Button>
+    </main>
+  )
+}
+```
+
+---
+
+## Package Boundary Rules
+
+| Package | Can Import | Cannot Import |
+|---------|------------|---------------|
+| `database` | - | Any other package |
+| `dal` | `database` | `ui`, apps |
+| `ui` | - | `database`, `dal` |
+| `apps/web` | `dal`, `ui` | `database` directly |
+
+---
+
+## Do / Don't
+
+### Do
+
+- Keep database package minimal (schema + client only)
+- Use DAL for all database operations
+- Use `server-only` in DAL packages
+- Export tailwind config from UI package
+- Use transpilePackages in Next.js config
+
+### Don't
+
+- Don't import `@repo/database` from apps
+- Don't put business logic in database package
+- Don't skip DAL for "simple" queries
+- Don't duplicate tailwind theme in apps

package/skills/app-dev/monorepo/release-check.mjs

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const DAY_MS = 24 * 60 * 60 * 1000;
+const WEEK_MS = 7 * DAY_MS;
+const here = dirname(fileURLToPath(import.meta.url));
+
+function readJson(path, fallback = {}) {
+  try { return JSON.parse(readFileSync(path, 'utf8')); } catch { return fallback; }
+}
+
+function frontmatterValue(text, key) {
+  const frontmatter = /^---\n([\s\S]*?)\n---/.exec(text)?.[1] ?? '';
+  const match = new RegExp('^' + key + ':\\s*([^\\n]+)$', 'm').exec(frontmatter);
+  return match?.[1].trim().replace(/^['"]|['"]$/g, '') ?? null;
+}
+
+function repositoryOf(source) {
+  const value = String(source ?? '').trim();
+  const match = /^(?:git@github\.com:|https:\/\/github\.com\/)?([A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+?)(?:\.git)?$/.exec(value);
+  return match?.[1] ?? null;
+}
+
+function stableVersion(value) {
+  const match = /^v?(\d+)\.(\d+)\.(\d+)$/.exec(String(value ?? '').trim());
+  return match ? match.slice(1).map(Number) : null;
+}
+
+function newer(left, right) {
+  for (let index = 0; index < 3; index += 1) {
+    if (left[index] !== right[index]) return left[index] > right[index];
+  }
+  return false;
+}
+
+function writeCache(path, value) {
+  try {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(value));
+  } catch { /* A read-only cache must not block skill use. */ }
+}
+
+function main(now = Date.now()) {
+  if (process.env.ONEABOVEIO_NO_UPDATE_CHECK) return;
+  const skill = readFileSync(join(here, 'SKILL.md'), 'utf8');
+  const name = frontmatterValue(skill, 'name');
+  const localVersion = stableVersion(frontmatterValue(skill, 'release-version'));
+  if (!name || !localVersion) return;
+
+  const lock = readJson(join(process.env.HOME || homedir(), '.agents', '.skill-lock.json'));
+  const entry = lock.skills?.[name];
+  const repository = repositoryOf(entry?.sourceUrl || entry?.source);
+  if (!repository) return;
+
+  const cacheRoot = process.env.XDG_CACHE_HOME || join(process.env.HOME || homedir(), '.cache');
+  const cachePath = join(cacheRoot, '1aboveio-skills', 'release-check.json');
+  const all = readJson(cachePath);
+  const cache = all[repository] && typeof all[repository] === 'object' ? all[repository] : {};
+
+  if (!cache.lastCheck || now - cache.lastCheck >= DAY_MS) {
+    const result = spawnSync('gh', ['api', 'repos/' + repository + '/releases/latest', '--jq', '.tag_name'], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+      timeout: 1500,
+    });
+    cache.lastCheck = now;
+    if (result.status === 0 && stableVersion(result.stdout)) cache.latestTag = result.stdout.trim();
+    else delete cache.latestTag;
+    all[repository] = cache;
+    writeCache(cachePath, all);
+  }
+
+  const latestVersion = stableVersion(cache.latestTag);
+  if (!latestVersion || !newer(latestVersion, localVersion)) return;
+  if (cache.notifiedTag === cache.latestTag && cache.notifiedAt && now - cache.notifiedAt < WEEK_MS) return;
+
+  cache.notifiedTag = cache.latestTag;
+  cache.notifiedAt = now;
+  all[repository] = cache;
+  writeCache(cachePath, all);
+  const command = `npx skills@1.5.23 add '${repository}#${cache.latestTag}' --global --agent universal claude-code --skill ${name} --yes`;
+  process.stdout.write(
+    `UPDATE_AVAILABLE: A newer 1AboveIO skills release (${cache.latestTag}) is available; this skill is `
+      + `v${localVersion.join('.')}. Ask once whether to refresh ${name}. On approval run \`${command}\`. `
+      + 'The refreshed instructions apply next session. Either way, continue the current task and do not ask again this session.\n',
+  );
+}
+
+try { main(); } catch { /* Update checks are advisory and always fail silent. */ }

package/skills/app-dev/nextjs-fullstack/LICENSE

@@ -0,0 +1,3 @@
+MIT License
+
+Copyright (c) 2026 1AboveIO