@hasna/skills 0.1.26 → 0.1.29

package/skills/scaffold-project/src/project-config.ts

@@ -0,0 +1,338 @@
+import { join } from "path";
+
+import { TEMPLATES } from "./templates";
+import type { ProjectConfig, ScaffoldOptions, Template } from "./types";
+
+export function generateProjectConfig(options: ScaffoldOptions): ProjectConfig {
+  const template = TEMPLATES[options.template!];
+  const name = options.name || 'my-app';
+  const outputDir = options.output || join(process.cwd(), name);
+
+  const config: ProjectConfig = {
+    name,
+    template: options.template!,
+    outputDir,
+    dependencies: [...template.defaultDeps],
+    devDependencies: [...template.defaultDevDeps],
+    scripts: {},
+    files: [],
+    features: [],
+  };
+
+  // Add TypeScript
+  if (options.typescript) {
+    config.features.push('typescript');
+  }
+
+  // Add Tailwind CSS
+  if (options.tailwind) {
+    config.dependencies.push('tailwindcss', 'autoprefixer', 'postcss');
+    config.features.push('tailwind');
+  }
+
+  // Add shadcn/ui
+  if (options.shadcn) {
+    config.dependencies.push('class-variance-authority', 'clsx', 'tailwind-merge');
+    config.devDependencies.push('tailwindcss-animate');
+    config.features.push('shadcn');
+  }
+
+  // Add database
+  if (options.database !== 'none') {
+    config.features.push(`database:${options.database}`);
+
+    if (options.database === 'prisma') {
+      config.dependencies.push('@prisma/client');
+      config.devDependencies.push('prisma');
+    } else if (options.database === 'drizzle') {
+      config.dependencies.push('drizzle-orm', 'postgres');
+      config.devDependencies.push('drizzle-kit');
+    } else if (options.database === 'supabase') {
+      config.dependencies.push('@supabase/supabase-js');
+    }
+  }
+
+  // Add authentication
+  if (options.auth !== 'none') {
+    config.features.push(`auth:${options.auth}`);
+
+    if (options.auth === 'nextauth') {
+      config.dependencies.push('next-auth');
+    } else if (options.auth === 'clerk') {
+      config.dependencies.push('@clerk/nextjs');
+    } else if (options.auth === 'lucia') {
+      config.dependencies.push('lucia');
+    }
+  }
+
+  // Add testing
+  if (options.testing !== 'none') {
+    config.features.push(`testing:${options.testing}`);
+
+    if (options.testing === 'vitest' || options.testing === 'both') {
+      config.devDependencies.push('vitest', '@vitest/ui');
+    }
+    if (options.testing === 'playwright' || options.testing === 'both') {
+      config.devDependencies.push('@playwright/test');
+    }
+  }
+
+  // Add state management
+  if (options.state !== 'none') {
+    config.features.push(`state:${options.state}`);
+
+    if (options.state === 'zustand') {
+      config.dependencies.push('zustand');
+    } else if (options.state === 'jotai') {
+      config.dependencies.push('jotai');
+    } else if (options.state === 'redux') {
+      config.dependencies.push('@reduxjs/toolkit', 'react-redux');
+    }
+  }
+
+  // Add ESLint and Prettier
+  config.devDependencies.push('eslint', 'prettier');
+
+  return config;
+}
+
+export function generateScripts(template: Template, options: ScaffoldOptions): Record<string, string> {
+  const scripts: Record<string, string> = {
+    dev: 'next dev',
+    build: 'next build',
+    start: 'next start',
+    lint: 'eslint .',
+    format: 'prettier --write .',
+  };
+
+  // Template-specific scripts
+  if (template === 'next') {
+    scripts.dev = 'next dev';
+    scripts.build = 'next build';
+    scripts.start = 'next start';
+  } else if (template === 'react') {
+    scripts.dev = 'vite';
+    scripts.build = 'vite build';
+    scripts.preview = 'vite preview';
+  } else if (template === 'express' || template === 'rest-api') {
+    scripts.dev = 'tsx watch src/index.ts';
+    scripts.build = 'tsc';
+    scripts.start = 'node dist/index.js';
+  }
+
+  // Database scripts
+  if (options.database === 'prisma') {
+    scripts['db:generate'] = 'prisma generate';
+    scripts['db:push'] = 'prisma db push';
+    scripts['db:migrate'] = 'prisma migrate dev';
+    scripts['db:studio'] = 'prisma studio';
+  } else if (options.database === 'drizzle') {
+    scripts['db:generate'] = 'drizzle-kit generate';
+    scripts['db:migrate'] = 'drizzle-kit migrate';
+    scripts['db:studio'] = 'drizzle-kit studio';
+  }
+
+  // Testing scripts
+  if (options.testing === 'vitest' || options.testing === 'both') {
+    scripts.test = 'vitest';
+    scripts['test:ui'] = 'vitest --ui';
+  }
+  if (options.testing === 'playwright' || options.testing === 'both') {
+    scripts['test:e2e'] = 'playwright test';
+  }
+
+  return scripts;
+}
+
+export function generateTsConfig(template: Template): any {
+  return {
+    compilerOptions: {
+      target: 'ES2020',
+      lib: ['ES2020', 'DOM', 'DOM.Iterable'],
+      module: 'ESNext',
+      skipLibCheck: true,
+      moduleResolution: 'bundler',
+      allowImportingTsExtensions: true,
+      resolveJsonModule: true,
+      isolatedModules: true,
+      noEmit: true,
+      jsx: template.includes('react') || template === 'next' ? 'preserve' : undefined,
+      strict: true,
+      noUnusedLocals: true,
+      noUnusedParameters: true,
+      noFallthroughCasesInSwitch: true,
+      baseUrl: '.',
+      paths: {
+        '@/*': ['./src/*'],
+      },
+    },
+    include: ['src'],
+    exclude: ['node_modules'],
+  };
+}
+
+export function generateGitignore(template: Template): string {
+  return `# Dependencies
+node_modules
+.pnp
+.pnp.js
+
+# Testing
+coverage
+.nyc_output
+
+# Next.js
+.next
+out
+
+# Production
+build
+dist
+
+# Misc
+.DS_Store
+*.pem
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Local env files
+.env
+.env*.local
+
+# Vercel
+.vercel
+
+# TypeScript
+*.tsbuildinfo
+next-env.d.ts
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+*~
+`;
+}
+
+export function generateEnvExample(options: ScaffoldOptions): string {
+  let env = '# Environment Variables\n\n';
+
+  if (options.database === 'prisma' || options.database === 'drizzle') {
+    env += '# Database\n';
+    env += 'DATABASE_URL="postgresql://user:password@localhost:5432/dbname"\n\n';
+  }
+
+  if (options.database === 'supabase' || options.auth === 'supabase') {
+    env += '# Supabase\n';
+    env += 'NEXT_PUBLIC_SUPABASE_URL="your-supabase-url"\n';
+    env += 'NEXT_PUBLIC_SUPABASE_ANON_KEY="your-supabase-anon-key"\n\n';
+  }
+
+  if (options.auth === 'nextauth') {
+    env += '# NextAuth\n';
+    env += 'NEXTAUTH_URL="http://localhost:3000"\n';
+    env += 'NEXTAUTH_SECRET="your-secret-here"\n\n';
+  }
+
+  if (options.auth === 'clerk') {
+    env += '# Clerk\n';
+    env += 'NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY="your-publishable-key"\n';
+    env += 'CLERK_SECRET_KEY="your-secret-key"\n\n';
+  }
+
+  return env;
+}
+
+export function generateReadme(config: ProjectConfig, options: ScaffoldOptions): string {
+  const { name, template } = config;
+  const templateInfo = TEMPLATES[template];
+
+  return `# ${name}
+
+${templateInfo.description}
+
+## Tech Stack
+
+- **Framework**: ${templateInfo.name}
+${options.typescript ? '- **Language**: TypeScript\n' : ''}${options.tailwind ? '- **Styling**: Tailwind CSS\n' : ''}${options.shadcn ? '- **UI**: shadcn/ui\n' : ''}${options.database !== 'none' ? `- **Database**: ${options.database}\n` : ''}${options.auth !== 'none' ? `- **Auth**: ${options.auth}\n` : ''}${options.testing !== 'none' ? `- **Testing**: ${options.testing}\n` : ''}${options.state !== 'none' ? `- **State**: ${options.state}\n` : ''}
+## Prerequisites
+
+- Node.js 18+ (or Bun)
+- ${options.database === 'prisma' || options.database === 'drizzle' ? 'PostgreSQL database' : ''}
+
+## Getting Started
+
+1. Install dependencies:
+
+\`\`\`bash
+${options.pm} install
+\`\`\`
+
+2. Copy environment variables:
+
+\`\`\`bash
+cp .env.example .env
+\`\`\`
+
+3. Fill in the environment variables in \`.env\`
+
+${options.database === 'prisma' ? `4. Setup database:
+
+\`\`\`bash
+${options.pm} db:generate
+${options.pm} db:push
+\`\`\`
+
+` : ''}${options.database === 'drizzle' ? `4. Setup database:
+
+\`\`\`bash
+${options.pm} db:generate
+${options.pm} db:migrate
+\`\`\`
+
+` : ''}5. Run the development server:
+
+\`\`\`bash
+${options.pm} ${options.pm === 'npm' ? 'run ' : ''}dev
+\`\`\`
+
+## Available Scripts
+
+- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}dev\` - Start development server
+- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}build\` - Build for production
+- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}start\` - Start production server
+- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}lint\` - Run ESLint
+- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}format\` - Format code with Prettier
+${options.testing !== 'none' ? `- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}test\` - Run tests\n` : ''}
+## Project Structure
+
+\`\`\`
+${name}/
+├── src/
+│   ├── app/          # Application routes
+│   ├── components/   # React components
+│   ├── lib/          # Utility functions
+│   └── types/        # TypeScript types
+├── public/           # Static assets
+├── .env.example      # Environment variables template
+├── package.json
+└── README.md
+\`\`\`
+
+## Learn More
+
+- [${templateInfo.name} Documentation](https://nextjs.org/docs)
+${options.tailwind ? '- [Tailwind CSS](https://tailwindcss.com/docs)\n' : ''}${options.shadcn ? '- [shadcn/ui](https://ui.shadcn.com)\n' : ''}${options.database === 'prisma' ? '- [Prisma](https://www.prisma.io/docs)\n' : ''}${options.database === 'drizzle' ? '- [Drizzle](https://orm.drizzle.team)\n' : ''}
+## Deployment
+
+Deploy your application on [Vercel](https://vercel.com) or [Railway](https://railway.app).
+
+---
+
+Generated with [scaffold-project](https://skills.md/skills/scaffold-project)
+`;
+}

package/skills/scaffold-project/src/templates.ts

@@ -0,0 +1,173 @@
+import type { Template } from "./types";
+
+export const TEMPLATES: Record<Template, {
+  name: string;
+  description: string;
+  category: string;
+  defaultDeps: string[];
+  defaultDevDeps: string[];
+}> = {
+  next: {
+    name: 'Next.js 15',
+    description: 'Next.js 15 App Router with React, TypeScript, and Tailwind',
+    category: 'frontend',
+    defaultDeps: ['next', 'react', 'react-dom'],
+    defaultDevDeps: ['@types/node', '@types/react', '@types/react-dom', 'typescript'],
+  },
+  react: {
+    name: 'React + Vite',
+    description: 'Vite + React + TypeScript',
+    category: 'frontend',
+    defaultDeps: ['react', 'react-dom'],
+    defaultDevDeps: ['@types/react', '@types/react-dom', '@vitejs/plugin-react', 'typescript', 'vite'],
+  },
+  vue: {
+    name: 'Vue 3 + Vite',
+    description: 'Vite + Vue 3 + TypeScript',
+    category: 'frontend',
+    defaultDeps: ['vue'],
+    defaultDevDeps: ['@vitejs/plugin-vue', 'typescript', 'vite', 'vue-tsc'],
+  },
+  svelte: {
+    name: 'SvelteKit',
+    description: 'SvelteKit + TypeScript',
+    category: 'frontend',
+    defaultDeps: ['svelte'],
+    defaultDevDeps: ['@sveltejs/adapter-auto', '@sveltejs/kit', 'typescript', 'vite'],
+  },
+  astro: {
+    name: 'Astro',
+    description: 'Astro + TypeScript',
+    category: 'frontend',
+    defaultDeps: ['astro'],
+    defaultDevDeps: ['@astrojs/tailwind', 'typescript'],
+  },
+  remix: {
+    name: 'Remix',
+    description: 'Remix + TypeScript',
+    category: 'frontend',
+    defaultDeps: ['@remix-run/node', '@remix-run/react', '@remix-run/serve', 'react', 'react-dom'],
+    defaultDevDeps: ['@remix-run/dev', '@types/react', '@types/react-dom', 'typescript'],
+  },
+  express: {
+    name: 'Express.js',
+    description: 'Express + TypeScript',
+    category: 'backend',
+    defaultDeps: ['express', 'cors', 'dotenv'],
+    defaultDevDeps: ['@types/express', '@types/cors', '@types/node', 'typescript', 'tsx'],
+  },
+  fastapi: {
+    name: 'FastAPI',
+    description: 'FastAPI + Python',
+    category: 'backend',
+    defaultDeps: ['fastapi', 'uvicorn', 'pydantic'],
+    defaultDevDeps: ['black', 'pytest'],
+  },
+  hono: {
+    name: 'Hono',
+    description: 'Hono + TypeScript (edge-ready)',
+    category: 'backend',
+    defaultDeps: ['hono'],
+    defaultDevDeps: ['@types/node', 'typescript'],
+  },
+  elysia: {
+    name: 'Elysia',
+    description: 'Elysia + Bun + TypeScript',
+    category: 'backend',
+    defaultDeps: ['elysia'],
+    defaultDevDeps: ['bun-types'],
+  },
+  nestjs: {
+    name: 'NestJS',
+    description: 'NestJS + TypeScript',
+    category: 'backend',
+    defaultDeps: ['@nestjs/common', '@nestjs/core', '@nestjs/platform-express', 'reflect-metadata', 'rxjs'],
+    defaultDevDeps: ['@nestjs/cli', '@types/node', 'typescript'],
+  },
+  t3: {
+    name: 'T3 Stack',
+    description: 'Next.js + tRPC + Prisma + NextAuth',
+    category: 'fullstack',
+    defaultDeps: ['next', 'react', 'react-dom', '@trpc/client', '@trpc/server', '@trpc/react-query', '@tanstack/react-query', 'zod'],
+    defaultDevDeps: ['@types/node', '@types/react', '@types/react-dom', 'typescript'],
+  },
+  'nextjs-supabase': {
+    name: 'Next.js + Supabase',
+    description: 'Next.js + Supabase',
+    category: 'fullstack',
+    defaultDeps: ['next', 'react', 'react-dom', '@supabase/supabase-js'],
+    defaultDevDeps: ['@types/node', '@types/react', '@types/react-dom', 'typescript'],
+  },
+  'remix-prisma': {
+    name: 'Remix + Prisma',
+    description: 'Remix + Prisma ORM',
+    category: 'fullstack',
+    defaultDeps: ['@remix-run/node', '@remix-run/react', '@remix-run/serve', 'react', 'react-dom', '@prisma/client'],
+    defaultDevDeps: ['@remix-run/dev', '@types/react', '@types/react-dom', 'typescript', 'prisma'],
+  },
+  'rest-api': {
+    name: 'REST API',
+    description: 'REST API boilerplate',
+    category: 'api',
+    defaultDeps: ['express', 'cors', 'dotenv'],
+    defaultDevDeps: ['@types/express', '@types/cors', '@types/node', 'typescript', 'tsx'],
+  },
+  graphql: {
+    name: 'GraphQL API',
+    description: 'GraphQL API (Apollo Server)',
+    category: 'api',
+    defaultDeps: ['@apollo/server', 'graphql'],
+    defaultDevDeps: ['@types/node', 'typescript'],
+  },
+  trpc: {
+    name: 'tRPC API',
+    description: 'tRPC API',
+    category: 'api',
+    defaultDeps: ['@trpc/server', 'zod'],
+    defaultDevDeps: ['@types/node', 'typescript'],
+  },
+  cli: {
+    name: 'CLI Tool',
+    description: 'CLI tool with Commander.js or Bun',
+    category: 'other',
+    defaultDeps: ['commander'],
+    defaultDevDeps: ['@types/node', 'typescript'],
+  },
+  'chrome-extension': {
+    name: 'Chrome Extension',
+    description: 'Chrome extension boilerplate',
+    category: 'other',
+    defaultDeps: [],
+    defaultDevDeps: ['@types/chrome', 'typescript'],
+  },
+  electron: {
+    name: 'Electron',
+    description: 'Electron desktop app',
+    category: 'other',
+    defaultDeps: ['electron'],
+    defaultDevDeps: ['@types/node', 'typescript'],
+  },
+  'react-native': {
+    name: 'React Native',
+    description: 'React Native mobile app',
+    category: 'other',
+    defaultDeps: ['react', 'react-native'],
+    defaultDevDeps: ['@types/react', 'typescript'],
+  },
+  tauri: {
+    name: 'Tauri',
+    description: 'Tauri desktop app',
+    category: 'other',
+    defaultDeps: ['@tauri-apps/api'],
+    defaultDevDeps: ['@tauri-apps/cli', 'typescript'],
+  },
+  monorepo: {
+    name: 'Turborepo Monorepo',
+    description: 'Turborepo monorepo',
+    category: 'other',
+    defaultDeps: [],
+    defaultDevDeps: ['turbo'],
+  },
+};
+
+// ============================================================================

package/skills/scaffold-project/src/types.ts

@@ -0,0 +1,58 @@
+export const ALLOWED_PACKAGE_MANAGERS = ['npm', 'yarn', 'pnpm', 'bun'] as const;
+
+export function validatePackageManager(pm: string): asserts pm is PackageManager {
+  if (!ALLOWED_PACKAGE_MANAGERS.includes(pm as PackageManager)) {
+    throw new Error(
+      `Invalid package manager: "${pm}". Must be one of: ${ALLOWED_PACKAGE_MANAGERS.join(', ')}`
+    );
+  }
+}
+
+// ============================================================================
+// Types & Interfaces
+// ============================================================================
+
+export type Template =
+  | 'next' | 'react' | 'vue' | 'svelte' | 'astro' | 'remix'
+  | 'express' | 'fastapi' | 'hono' | 'elysia' | 'nestjs'
+  | 't3' | 'nextjs-supabase' | 'remix-prisma'
+  | 'rest-api' | 'graphql' | 'trpc'
+  | 'cli' | 'chrome-extension' | 'electron' | 'react-native' | 'tauri' | 'monorepo';
+
+export type Database = 'prisma' | 'drizzle' | 'supabase' | 'none';
+export type Auth = 'nextauth' | 'clerk' | 'lucia' | 'supabase' | 'none';
+export type Testing = 'vitest' | 'playwright' | 'both' | 'none';
+export type State = 'zustand' | 'jotai' | 'redux' | 'none';
+export type PackageManager = 'npm' | 'yarn' | 'pnpm' | 'bun';
+
+export interface ScaffoldOptions {
+  description?: string;
+  template?: Template;
+  name?: string;
+  output?: string;
+  typescript: boolean;
+  tailwind: boolean;
+  shadcn: boolean;
+  database: Database;
+  auth: Auth;
+  testing: Testing;
+  state: State;
+  git: boolean;
+  install: boolean;
+  pm: PackageManager;
+  dryRun: boolean;
+  verbose: boolean;
+}
+
+export interface ProjectConfig {
+  name: string;
+  template: Template;
+  outputDir: string;
+  dependencies: string[];
+  devDependencies: string[];
+  scripts: Record<string, string>;
+  files: Array<{ path: string; content: string }>;
+  features: string[];
+}
+
+// ============================================================================

package/skills/scientific-figure-check/package.json

@@ -11,7 +11,9 @@
     "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {},
+  "dependencies": {
+    "image-size": "^2.0.2"
+  },
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"

package/skills/sdk-generator/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: sdk-generator
+description: Generate premium SDK scaffolds with typed client code, package files, tests, README, usage examples, API summary, and manifest.
+---
+
+# SDK Generator
+
+Generate a ready-to-edit TypeScript SDK scaffold for an API, SaaS product, internal service, or developer platform.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+
+## Usage
+
+```bash
+skills run sdk-generator "Billing API for usage meters and invoices" --name "meterkit" --resources "customers,meters,invoices"
+skills run sdk-generator --api "Project management API" --base-url "https://api.example.com" --auth api-key
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--api <text>` | API or product description. Positional text also works. | required |
+| `--name <text>` | SDK package name stem. | derived from API description |
+| `--base-url <url>` | Default API base URL. | https://api.example.com |
+| `--auth <mode>` | `bearer`, `api-key`, or `none`. | bearer |
+| `--resources <list>` | Comma-separated resource names. | users,projects,events |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `sdk/package.json`
+- `sdk/src/index.ts`
+- `sdk/src/client.ts`
+- `sdk/src/types.ts`
+- `sdk/test/client.test.ts`
+- `sdk/README.md`
+- `usage-examples.md`
+- `api-summary.md`
+- `manifest.json`
+
+After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.

package/skills/sdk-generator/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "sdk-generator",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Hosted premium SDK scaffold generator",
+  "type": "module",
+  "bin": {
+    "sdk-generator": "./src/index.ts"
+  }
+}

package/skills/sdk-generator/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"]
+}