superkit-mcp-server 1.0.2 → 1.1.0

package/skills/meta/debug/templates/bug-report.template.md

@@ -1,31 +1,31 @@
-# Bug Report: {Short Description}
-
-## Overview
-- **Impact**: {High/Medium/Low}
-- **Frequency**: {Always/Intermittent/Once}
-- **Component**: {Part of the system}
-
-## Reproduction Steps
-1. Navigate to '...'
-2. Click on '...'
-3. See error '...'
-
-## Expected Behavior
-{What should happen?}
-
-## Actual Behavior
-{What actually happens?}
-
-## Environment
-- **Browser**: {e.g. Chrome 120}
-- **OS**: {e.g. macOS Sonoma}
-- **User Role**: {e.g. Admin/User}
-
-## Logs / Errors
-```
-{Paste logs here}
-```
-
-## Possible Root Cause
-- {Hypothesis 1}
-- {Hypothesis 2}
+# Bug Report: {Short Description}
+
+## Overview
+- **Impact**: {High/Medium/Low}
+- **Frequency**: {Always/Intermittent/Once}
+- **Component**: {Part of the system}
+
+## Reproduction Steps
+1. Navigate to '...'
+2. Click on '...'
+3. See error '...'
+
+## Expected Behavior
+{What should happen?}
+
+## Actual Behavior
+{What actually happens?}
+
+## Environment
+- **Browser**: {e.g. Chrome 120}
+- **OS**: {e.g. macOS Sonoma}
+- **User Role**: {e.g. Admin/User}
+
+## Logs / Errors
+```
+{Paste logs here}
+```
+
+## Possible Root Cause
+- {Hypothesis 1}
+- {Hypothesis 2}

package/skills/meta/debug/workflows/reproduce-issue.md

@@ -1,20 +1,20 @@
-# Reproduction Workflow
-
-## 1. Isolate the Variable
-- Can you reproduce it in a different browser?
-- Can you reproduce it with a different user?
-- Can you reproduce it locally vs prod?
-
-## 2. Create Minimal Reproduction
-Try to strip away all unnecessary complexity.
-
-**Frontend:**
-- Create a test case in a relevant `.test.tsx` file that mimics the user interaction.
-
-**Backend:**
-- Create a script in `scripts/repro/` that triggers the API call.
-
-## 3. Scripts
-Use these scripts to help:
-- `./scripts/push-env.sh` (Sync environment variables)
-- `npm run test` (Run unit tests)
+# Reproduction Workflow
+
+## 1. Isolate the Variable
+- Can you reproduce it in a different browser?
+- Can you reproduce it with a different user?
+- Can you reproduce it locally vs prod?
+
+## 2. Create Minimal Reproduction
+Try to strip away all unnecessary complexity.
+
+**Frontend:**
+- Create a test case in a relevant `.test.tsx` file that mimics the user interaction.
+
+**Backend:**
+- Create a script in `scripts/repro/` that triggers the API call.
+
+## 3. Scripts
+Use these scripts to help:
+- `./scripts/push-env.sh` (Sync environment variables)
+- `npm run test` (Run unit tests)

package/skills/meta/docker/SKILL.md

@@ -1,126 +1,126 @@
-# Docker Skill
-
-## Overview
-Container optimization, multi-stage builds, and Docker best practices.
-
-## Multi-Stage Build
-
-```dockerfile
-# Stage 1: Build
-FROM node:20-alpine AS builder
-WORKDIR /app
-
-# Install dependencies first (cache layer)
-COPY package*.json ./
-RUN npm ci
-
-# Build application
-COPY . .
-RUN npm run build
-
-# Stage 2: Production
-FROM node:20-alpine AS production
-WORKDIR /app
-
-# Create non-root user
-RUN addgroup -g 1001 -S nodejs && \
-    adduser -S nextjs -u 1001
-
-# Copy only production dependencies
-COPY --from=builder /app/node_modules ./node_modules
-COPY --from=builder /app/dist ./dist
-COPY --from=builder /app/package.json ./
-
-# Run as non-root
-USER nextjs
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
-  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
-
-EXPOSE 3000
-CMD ["node", "dist/server.js"]
-```
-
-## Docker Compose
-
-```yaml
-version: '3.8'
-
-services:
-  app:
-    build:
-      context: .
-      target: production
-    ports:
-      - "3000:3000"
-    environment:
-      - NODE_ENV=production
-      - DATABASE_URL=postgres://db:5432/myapp
-    depends_on:
-      db:
-        condition: service_healthy
-    restart: unless-stopped
-
-  db:
-    image: postgres:16-alpine
-    volumes:
-      - postgres_data:/var/lib/postgresql/data
-    environment:
-      POSTGRES_DB: myapp
-      POSTGRES_USER: user
-      POSTGRES_PASSWORD_FILE: /run/secrets/db_password
-    secrets:
-      - db_password
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U user -d myapp"]
-      interval: 5s
-      timeout: 5s
-      retries: 5
-
-  redis:
-    image: redis:7-alpine
-    volumes:
-      - redis_data:/data
-    command: redis-server --appendonly yes
-
-volumes:
-  postgres_data:
-  redis_data:
-
-secrets:
-  db_password:
-    file: ./secrets/db_password.txt
-```
-
-## Best Practices
-
-### Image Size Optimization
-```dockerfile
-# Use alpine base
-FROM node:20-alpine
-
-# Install only production deps
-RUN npm ci --only=production
-
-# Remove unnecessary files
-RUN rm -rf /var/cache/apk/*
-```
-
-### .dockerignore
-```
-node_modules
-.git
-.gitignore
-*.md
-.env*
-coverage
-.nyc_output
-dist
-```
-
-### Security
-- Run as non-root user
-- Use secrets for sensitive data
-- Scan images: `docker scout cves myimage`
-- Keep base images updated
+# Docker Skill
+
+## Overview
+Container optimization, multi-stage builds, and Docker best practices.
+
+## Multi-Stage Build
+
+```dockerfile
+# Stage 1: Build
+FROM node:20-alpine AS builder
+WORKDIR /app
+
+# Install dependencies first (cache layer)
+COPY package*.json ./
+RUN npm ci
+
+# Build application
+COPY . .
+RUN npm run build
+
+# Stage 2: Production
+FROM node:20-alpine AS production
+WORKDIR /app
+
+# Create non-root user
+RUN addgroup -g 1001 -S nodejs && \
+    adduser -S nextjs -u 1001
+
+# Copy only production dependencies
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/package.json ./
+
+# Run as non-root
+USER nextjs
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
+
+EXPOSE 3000
+CMD ["node", "dist/server.js"]
+```
+
+## Docker Compose
+
+```yaml
+version: '3.8'
+
+services:
+  app:
+    build:
+      context: .
+      target: production
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=production
+      - DATABASE_URL=postgres://db:5432/myapp
+    depends_on:
+      db:
+        condition: service_healthy
+    restart: unless-stopped
+
+  db:
+    image: postgres:16-alpine
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    environment:
+      POSTGRES_DB: myapp
+      POSTGRES_USER: user
+      POSTGRES_PASSWORD_FILE: /run/secrets/db_password
+    secrets:
+      - db_password
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U user -d myapp"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  redis:
+    image: redis:7-alpine
+    volumes:
+      - redis_data:/data
+    command: redis-server --appendonly yes
+
+volumes:
+  postgres_data:
+  redis_data:
+
+secrets:
+  db_password:
+    file: ./secrets/db_password.txt
+```
+
+## Best Practices
+
+### Image Size Optimization
+```dockerfile
+# Use alpine base
+FROM node:20-alpine
+
+# Install only production deps
+RUN npm ci --only=production
+
+# Remove unnecessary files
+RUN rm -rf /var/cache/apk/*
+```
+
+### .dockerignore
+```
+node_modules
+.git
+.gitignore
+*.md
+.env*
+coverage
+.nyc_output
+dist
+```
+
+### Security
+- Run as non-root user
+- Use secrets for sensitive data
+- Scan images: `docker scout cves myimage`
+- Keep base images updated

package/skills/meta/examples/supabase/SKILL.md

@@ -1,46 +1,46 @@
----
-name: supabase
-description: Database, auth, and backend expertise for Supabase operations in [PROJECT_NAME]
-last_updated: 2025-12-21
----
-
-# Supabase Skill
-
-## Overview
-
-Provides comprehensive expertise for Supabase development in [PROJECT_NAME] including:
-- Database schema design and migrations
-- Row Level Security (RLS) policy implementation
-- Auth integration debugging
-- Performance optimization
-
-## When To Use
-
-- Creating or modifying database schemas
-- Writing database migrations
-- Implementing RLS policies
-- Debugging Supabase auth or query issues
-- Optimizing database performance
-
-## Instrumentation
-
-```bash
-# Log usage when using this skill
-./scripts/log-skill.sh "supabase" "manual" "$$"
-```
-
-## What do you want to do?
-
-1. **Create Database Migration** → Read `workflows/migration-workflow.md`
-2. **Design RLS Policies** → Read `workflows/rls-policies.md`
-3. **Debug Supabase Issues** → Read `workflows/debugging.md`
-4. **Design Database Schema** → Read `workflows/schema-design.md`
-5. **Review Best Practices** → Read `references/best-practices.md`
-6. **See Common Patterns** → Read `references/common-patterns.md`
-
-## Quick Reference
-
-**Migration Template:** `templates/migration-template.sql`  
-**RLS Template:** `templates/rls-policy-template.sql`  
-**Existing Migrations:** `backend/migrations/`  
-**Supabase Client:** `lib/supabaseClient.ts`
+---
+name: supabase
+description: Database, auth, and backend expertise for Supabase operations in [PROJECT_NAME]
+last_updated: 2025-12-21
+---
+
+# Supabase Skill
+
+## Overview
+
+Provides comprehensive expertise for Supabase development in [PROJECT_NAME] including:
+- Database schema design and migrations
+- Row Level Security (RLS) policy implementation
+- Auth integration debugging
+- Performance optimization
+
+## When To Use
+
+- Creating or modifying database schemas
+- Writing database migrations
+- Implementing RLS policies
+- Debugging Supabase auth or query issues
+- Optimizing database performance
+
+## Instrumentation
+
+```bash
+# Log usage when using this skill
+./scripts/log-skill.sh "supabase" "manual" "$$"
+```
+
+## What do you want to do?
+
+1. **Create Database Migration** → Read `workflows/migration-workflow.md`
+2. **Design RLS Policies** → Read `workflows/rls-policies.md`
+3. **Debug Supabase Issues** → Read `workflows/debugging.md`
+4. **Design Database Schema** → Read `workflows/schema-design.md`
+5. **Review Best Practices** → Read `references/best-practices.md`
+6. **See Common Patterns** → Read `references/common-patterns.md`
+
+## Quick Reference
+
+**Migration Template:** `templates/migration-template.sql`  
+**RLS Template:** `templates/rls-policy-template.sql`  
+**Existing Migrations:** `backend/migrations/`  
+**Supabase Client:** `lib/supabaseClient.ts`